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HOW TO USE THIS BOOK ~ 


The Multics Condensed Guide is tabendsd as a 
quick reference book for a programmer at the 


console, The guide covers commands available 
in Limited Initial Multics (LIM), 


Where possible within a given section, material 
1s arranged alphabetically and there is only 

one topic on a page (a given command or request). 
To locate a command, simply turn to the appro- 
priate section and look it up alphabetically. 


The MCG is looseleaf; changes and additions 
will be made to it as appropriate. In addi- 
tion, the programmer may divide the book into 
sections keeping only those that he needs for 
his console work, 
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MCG TABLE OF CONTENTS 
How to Use This Book 
| 


SYSTEM CONVENTIONS 


Dialing In, Logging In, and Logging Out 


system Responses 
Standard Console Activities 


|NPUT STREAM 


Universal Character Conventions 
37KSR Teletypes 
1050 and 2741 Consoles 


COMMANDS 
Command Conventions 


Argument Formats for Commands 
Symbols Used in Commands 


addname — expand 

adjust extract_archive 
archive  fileio 

bepl files 

bind flusn 


branch fortran 
change_wdir — fg_chname 
chasepath fs_readacl 
contents -.- 1ocall 
convert_object = link 


copy | list 
ctss_aarchv listacl 
delacl — login 
delname Loe logout 
dorint merge_edit 


dounch movebranch 
echo mspeek 

edm | new_proc 
epl | nothing 
eplbsa 
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print 
print_dbrs 
Print_link info 
probe 

qdump 


ged 

read7 
remove | 
remove_dir 
rename 


runcom 
setacl 
start 
status 
tape_in 


tape_out 
time 


unlink 
who 


- MCG_TABLE OF CONTENTS 
MERGE_EDIT CONTROL SEGMENT LINES 


bcp] error 
core fetch 
deck insert 
entry libe 
epl load 
eplbsa maketl 


EDM REQUESTS 


backup 
bottom 
change 
delete 
find 

1 insert 
kill 

1 locate 


QED REQUESTS 


: absolute line 
append 
buffer 
change 
current line 
delete 
enter 
exclude 
global 

1 insert 


PROBE REQUESTS 


arglist 
dum)_process 
info 
initiate 
output 

quit 


notape 
pure 
symbol 
text+link 
tmg | 


next 
print 
quit 
retype 
save 
top 


verbose 


list 

move 

print 

quit 

read 

sort 
status 
substitute 
transform 
write 


=< 0 xX X7YAQOT Be 


segdump 
seginfo 
set 

stack 
state 
terminate 


111 Rev. 2 06019 


SYSTEM CONVENT LONS 


Dialing In 
Logging [In - 
Logging Out 


Standard System Responses 


Console Activities 

_ Working Directory 
Writing Source Programs 

~ Compilation and Assembly 
Execution 
Debugg ing 
Access Control 
File Transfer CTSS/Multics 


Console Interrupts 
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SYSTEM CONVENTIONS 
DI ALING_IN 


No standard digit for Deaias into the Multics system 
has yet been assigned. When it is, the user will 
follow the procedure: 


Dial appropriate digit 


Listen for high-pitched tone 6 


Push DATA button on 2741 and 1050. 
(Automatic on TTY 37.) 


Watch for message veei Multics system to be 
printed out 


LOGGING IN 


Once Multics has responded to dialing in, the user 
1ssues a login command giving his personal name and 
project id as in: 


login Smith Multics 


The system asks for a user password, The user types 
in his password, for example: 


corncob 


Multics verifies the password and responds with 
R(eady) message. The user may now issue commands to 
Multics, 


LOGGING OUT 


When a user is ready to terminate a console session, 
he 1ssues a logout command, i.e., 


logout 


Multics responds with a W(ait), then issues the 
following message: 


personal_name project_id logged out 


Smith Multics logged out 
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SYSTEM CONVENTIONS 
STANDARD SYSTEM RESPONSES 


When the user dials into Multics, stand- 
ard system response is: | 


MULTICS in operation on date at time 
for example: | | 
ai in operation on Wed 8Nov 1968 at 09:23:18.85666 EST 


Multics may then follow with one or more 
timely messages to users, Multic terminates 
response with a R(eady)message giving timing 
information, For example: 


r Ost 070° ‘0 
where: | 


The first group of digits give the amount of 
- elapsed real time. | 


The second group of digits give the elapsed 
CPU time (used in timing commands). 


The third group of digits give the number of 
times a command waited for a page froma 
storage device. 


In dialing in, as shown in the example, only 
the first group of digits are significant. 


When the user issues a command to Multics the 
usual system response is a W(ait) while Multics 
takes appropriate action. When action is com- © 
plete, Multics then issues a R(eady), for example: 


w 929:19.4 
re "726. 5622: JO 


The number following a wait gives the time of 
day to the tenth of a second. — 
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SYSTEM CONVENTIONS 
CONSOLE ACTIVITIES 


When a user logs into Multics, a working direc- 
tory 1s set up for him. The directory has the 
forms 

>user_dir_dir>personal_name.pro ject_id 
Once the working directory has been set up, the 
user can add entry names of segments to his 
directory using the branch command, or estab- 
lish an entry by writing a segment in one of 
the editors, edm or qed. | 


Source programs are written in ane of the Multics 
languages by entering either the edm or ged 
editor (edm or ged command) and either giving a 
new entry name by which the program is to be 
called or using an existing entry name for it. 
The source program segment must be named with 

a second component that is the name of the 
compiler or assembler to be used, e.g., 


edm joe.epl 
qed sourceprog.eplbsa 
edm test.fortran 


Once in an editing system, the user writes his 
source program in the appropriate language. 


The source language program can be compiled | 
or assembled by issuing the appropriate 


language command (epl, eplbsa, bcpl, tmgl, 
POR tran) @.“6e. Oey | : 


epl joe 
eplbsa sourceprog 


fortran test 


After assembly, a program may be executed as 
a command by typing its name and arguments 
(provided all arguments are character 
Strings) = (€.04,5 


joe joedata 


l-4 Rev 2 06019 


SYSTEM CONVENTIONS 


CONSOLE ACTIVITIES 


If the text seopment fails to execute, the 
probe command and appropriate probe requests 
can be used to help debug the program. 


Access control commands (setacl, delacl and 
listacl) allow the user to give other users 
access to contents of his working directory 
Por reading, writing, executing, and appending 
to one or more of his segments. 


Means have been provided in Multics to 
transfer segments back and forth to the older 
GECOS operating system and to transfer 
Files on the 7094 CISS system to the Multics 
system and vice versa. (See tape_in and 


tape_ out commands and the merge_ edit com= 


mand with merge_edit control lines. 
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SYSTEM CONVENTIONS 
~ CONSOLE INTERRUPTS (QUIT) 


To stop a process or to return to command level, 
the user pushes the ATTENTION button once on 

the |BM 2741 and IBM 1050 or the INTERRUPT button 
once on the ITTY 37. 


All prior work is saved, so that the user may 
elther enter a new system or reenter the system § 
he was in when he issued the quit. 


After pushing the appropriate button, the system 
prints out 


quit 
and then 
r(eady) and the time. 


Lxamp le: | 
The user may be in EDM and wish to quit; the 
response may appear as follows: 
quit 3 
Pele “Sack Ze. 
After a quit, the user may wish to issue either 
a start command or a new_proc command. (The start 


and new_proc commands are appropriate only immediately 
after a quit.) 


The start command allows the user to resume at the 
point he quit and in the system he was in when he quit, 
EDM in the example. 


The new_proc command leaves the user in his previous 
working directory but creates a new process for the 
user, The old process is available for debugging. 6 
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INPUT STREAM 


Character Escape Convent ions 

Multics Universal Escape Conventions 
Erase and Kill 
Octal Codes 

| Stylistic Convention 

37KSR Teletypes 

IBM 1050 and 2741 Consoles 


[1-1 Rev 2 06019 — 


INPUT STREAM 


CHARACTER ESCAPE CONVENTIONS 

In Multics, all characters to and from external 
devices are translated to ASCI! by a table driven 
code conversion, Universal character escape 
conventions are provided for each type of console 
or card device attached to the system. However, 
each device may be used with stylized characters 
that represent some internal ASCI! characters or 
with escape conventions unique to the device. 

The following pages present the Multics universal 
escape conventions, the stylizations, and the 
escape conventions used with each device, 
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| INPUT STREAM 
~ MULTICS UNIVERSAL ESCAPE CONVENTIONS 


A. ERASE AND KILL CHARACTERS 


The standard erase and kill characters are: 
Character Meaning 
# , erase the previous character 
@ delete the current line 


B. OCTAL CODES 


To represent octal codes, type a "\" (left slant) 
and up to three octal digits. Example: 


N77 


C. STYLISTIC CONVENTION 


One stylistic convention holds at all consoles. 
The solid vertical bar (]) and the broken verti- 
cal bar () are considered alternatives of the 
graphic for ASCI! code value 174. 
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INPUT STREAM 


3'7KSR_TELETYPES 


There are no further escape conventions 
required for the use of the TTY37, since 
it uses the revised ASCI! character set. 


IBM_ 1050 AND 2741 CONSOLES 


_ Each type ball used would require a different 
set of escape conventions. The ball pre- 
sently implemented is the 963 type ball. 


The non-ASC|| characters on the 963 type 
ball are considered stylized versions of 
ASC|| characters: 


é (cent sign) for - (left slant) 
' (4postrophe) for (accent acute) 
“i (negation) for nO (circumflex) 


In addition, the following escapes are 
available: 


for (accent grave) 

for (left square bracket) 
for (right square bracket) 
for (left brace) 

for (right brace) 

for . (over line/ti lde) 
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COMMANDS 


Argument Formats for Commands 


Symbols Used in Commands 


Commands 


addname 
adjust 
archive 
bcpl 
bind 


branch 
change_wdir 
chasepath 
contents 
convert_ob ject 


copy 
ctss_aarchv 
delacl 
delname 
dprint 


dpunch 
echo 
edm 
epl 
eplbsa 


expand 
extract_archive 
fileio 

files 

flush © 


fortran 
f's_chname 
f's_readac] 
1ocal] » 
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link 
list 
listacl 
login 
logout 


merge_edit 
movebranch 
mspeek 
new_proc 
nothing 


print 

print dbrs 
print_link_info 
probe 

qdump7 


ged 

read7 
remove 
remove_dir 
rename 


runcom 
setacl 
start 
status 
tape_in 


tape_out 
time 
unlink 
who 


COMMAND CONVENTIONS 
ARGUMENT FORMATS FOR COMMANDS 


entry represents a unique entry name (branch or link) 
in the user's working directory, e.2., 


| mY —SEE 
ath is a general term for an argument that may 
represent one of the following: | 


(1) An entry name (branch or link) in the 
user's working directory or in another 
directory. If the entry name is in another 
directory, path must include enough of the 
pathname to the entry so that it can be 
Found, €.2., 


my_seg (implicit path to working 
directory entry) 
>joes_dir>zap.epl (explicit path to an 
entry in another directory) 
(2) A directory, indicated by a terminating >; 


path must include enough of the pathname so 
that the directory can be found, e.9., 


>freds_dir> 


where freds_dir is a unique directory in the 
file system. 


acname 1S an access control name representing the 
name of a user or set of users. lt differs 
from an entry name only in that it must have 
S 3 components, personal_name, project_id, and 


instance_tag; for example: 


Andrews.Multics.* (Tag is usually given 
as.* 
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COMMAND CONVENTIONS 


SYMBOLS USED |N COMMANDS 


Used to match any one component of a name 
(pathname, entry name, access control name) 
found in a list of names, for example, 


list my_dir>my_entry>*.my_seg 


might cause the listing the following 
names from the directory given as my_entry: 


Branches 


versionl.my_seg 
ver sion2.my_seg 
version3.my_seg 
newer s,my_seg 

last_try.my_seg 


** Used in a terminating position to match 
any number of components of an argument, i.e., 
list my_dir>alpha.** 


causes listing pathnames from my_dir. 
These might be: 


Branches 


alpha 
alpha. link 
alpha. beta.ep1 


Links 
alpha. >joe_dir>beta 
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COMMAND CONVENTIONS 


Separates components of entry names. Components 
may be without special significance, e. g., 


my_seg.a or my_seg.b 


However, many components have special meanings. 
When writing a source program in EDM or QcD, the 
second component of the name indicates the com- 
piler or assember to be used to translate the 
source program, e.9., 


edn my_seg.bcpl 


When the command to compile the source program 
is given the command is: 


bcpl my_seg 

Compilation and assembly that follow the bcpl 

command create the following segments: 
my_seg (text segment) 
my_seg.link (linkage segment) 
my_seg.symbol — (symbol table) 


With certain options in effect, the same command 
could also create: 


my_seg.list (ascii listing) 
my_seg.error (error segment) 
When my_seg is executed, the command is simply 


the text segment name followed by appropriate 
string arguments. 


The user can combine text, linkage, and symbol 
segments into a single ob ject segment, e.g., 


my_seg.ob ject 


Compilation, assembly, and execution of a seg- 
ment can be done with merge_edit and the GECOS 
system. A segment containing merge_edit instruc- 
tions 1s set up using EDM or QED. The first com- 
ponent of the entry name can optionally be that 
of the text segment; the second component is 
GECOS, E.f., edm my_seg.gecos 
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| COMMAND CONVENTIONS 
SYMBOLS USED IN COMMANDS 


Used only in the second argument of a command when 
Similar components appear in the arguments. 
= means duplicate the corresponding component of the 
first argument, e.g., 

rename my_seg.epl] =.pl 
Used only in the second argument of a command. 


== means duplicate all components following as taken 
From the first argument, e. Oey 


rename my_seg.epl.link your_seg.== 
Used in describing a pathname as follows: 


>a an initial > designates an absolute pathname, 
| 1.e., one fixed with respect to the root 
directory. (The > is the abbreviated name of 
the root directory. ) 


a terminal > indicates the entry ae 
preceding 18 a directory. 


infix > 1s used to show the path down to the 
required entry. The terminating entry may be 
itself a directory but as used here is treated 
as a terminating entry. 


Note that if the path, a>b, does not begin 
with >, then a is presumed to be in the current 
working directory. 


_Used in a pathname to describe motion up the 
directory hierarchy. >a>b>c<d means to follow the 
File system hierarchy down to c, then return to the 
directory containing c and progress down to d. 

The effective result is >a>b>d. This is especially 
useful in the case: 


<a>b 


which indicates entry b in directory a in the same 
directory that contains the current working directory. 
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me 


COMMAND CONVENTIONS 


SYMBOLS USED IN COMMANDS 


Parentheses delimit a set of iteration 
elements. Each element in the set is 
inserted in turn into the enclosing 
command and the command is evaluated. 
See the following paragraph on brackets 
for an example. 


Used as command delimiters. The en- 
closed character string is evaluated 
as a command and its value inserted in 
the command line; for example: 


print ([files * ,ep] |) 


The files command is evaluated and the 
values returned inserted in the command 
line. When files is evaluated, the print 
command might read: 


print (a.epl b.epl c.epl) 


Each of the three segments will then be 
printed in turn by the print command 
(because of the parentheses permitting 
iteration.) 


When a command in brackets is evaluated, 
the value is reexamined for further 
delimiters 


When a single vertical bar precedes a 
command in brackets, the value of the 
command is inserted into the command line 
but the command is not reexamined for 
further delimiters. 


I11-6 Rev 2 06019 


COMMAND CONVENTIONS 


OYMBOLS USED IN COMMANDS 


|1[] When double vertical bars precede a 
| command in brackets, the command is 
evaluated but the value is not in- 
serted into the command line. (The 
double vertical bar convention is 
the equivalent of an inter jected 
command in the previous command © 
language.) 


Command élements must be delimited 

by spaces. Defined delimiters need 

not be separated from enclosed ele- 
ments by spaces, e.g., [ x ] = [x]. 
Absence of a space between a delimiter 
and the rest of an element outside the 
delimiter indicates concatenation, e.g., 
~>a>b>(c de) indicates three pathnames: 


>a>b>c, >adb>d, and >a>b>de. 


Left and right accents denote a literal 
string. _ 


Double quotation marks also denote a 
literal string. However, a literal 

string enclosed in double quotation marks 
cannot be nested in another literal string 
also enclosed in double quotation marks. 


The end of a command is delimited by an 
ASC! | new line character. On the TTY37 
NL is indicated by pressing the 

LINE SPACE key; on the 2741 NL is indi- 
cated by pressing the RETURN key. 


A command delimiter, permitting commands 
to be stacked before execution. The 
commands are executed when an NL is 
encountered. 
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~ ADDNAME 


Format: 


Purpose: 


Notes: 


Example: 


COMMANDS 
Reference: BX.8.09 


addname path entry | 
To add an alternate entry name, entry to 
the existing entry name specified by 
path. 


Execute and write attributes must Ke on 


in the directory containing path. 


_ Equals convention permitted in entry. 


entry must be unique in the directory. 
addname >sys_lib>Smith.Multics.epl Jones.== 


where the name, Jones.Multics.epl is 
added to the entry, Smith.Multics.epl © 
in the directory, sys_lib. 
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Purpose: 


Example: 


COMMANDS | 
Reference: BX.99.08 


adjust path 
adjust$test path 
adjust$block path 

ad just$block_test path 
ad just$test_block path 


To correct the bit count for path, a ea 
moved from CTSS to Multics. 

(When a segment is moved, the Multics. 

bootload or tape_daemon eeednts the ETX that 
marks the end of CTSS file or any trailing 
asci1 NUL characters used in padding as part 
of the initial bit count. The adjust command 
corrects this. ) 

Meanings of the formats are: 


adjust path causes computation of bit 
count to and truncation of the segment 
at the last significant word. (Word 
containing characters other than NUL or 


ET). 


adjust$test path causes only printing of 
diagnostics that would apply if ac JHet 
were invoked for a bit count. 


adjust$block path uses the current length 
in 1024-word blocks to calculate the 
—segment's initial position. 


adjust$block_test path 
adjust$test_block path 
printing of diagnostics that would apply 
if adjust$block were invoked. 


adjust >sys_lib>ctsfil 


where segment, ctsfil, 1s truncated at the 
last word containing a significant character. 
A bit count is provided. 


cause only 
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ARCHIVE 


Format: 


Purpose: © 


Examples: 


COMMANDS | | 
Reference: BX.9.04 


archive key path entry] ... entryn 

To create, replace, delete, print headers of, 
move, or combine segments of archive segment 
path, where the segments are given by entryl... 
entryn. The name of an archive segment will 
have .archive appended if not already present. 


key is one of the following: 


d delete entryl...entryn from path 

r replace old entry1 to entryn with entryl... 
entryn. If an entry does not exist, it is 
added to the end of path. An r key can be 
used to create an archive segment path, if 
none exists. 


remove entry1...entryn from current working 
directory and place them in the archive 


seoment given by path. 


print headers of entryl...entryn in path. If 
no entries are given, all headers in path 


are printed. 


extract entry1...entryn from path and copy 
the entries nadia the directory of path. 
path is unchanged. 


Error messages are printed for: 
key other than d, r rd, t, or x 
path not an archive file 

path does not exist (with d or x) | 


entry cannot be found or cannot be moved (e.g., 
entry already exists on an x request) 
Secondary name .ob ject on a segment means that ~ 
text, link, and symbol segments are to be 


treated. | 
archive r my a b cc 


% 


creates segment my.archive with Sonpenents as. ‘Dig 
and cc. 


archive d my alpha.ob ject 
deletes alpha, alpha.link, and alpha.symbol 
from my.archive. 
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COMMANDS 


BCPL pe Reference: BX.7.06 


Format: bcp] path options © 
Purpose: To compile the source file, path, 
using BCPL. ~ 


Options:old compiler accepts old 


@ — (CTSS) BCPL syntax. | 
—listty list the source segment 


on-line rather than in a 
special list segment. 


comments on-line rather 
than in the path.error 


segment, 


errtty produce source code error 


produce a cross-referenced 
list of occurrences of each 
identifier in the program 
as part of the source seg- 
ment, 


BCPL does not call EPLBSA 
assembler when compilation 
1s done, Text and link 
segments are not produced, 
Primary output 1s a com- 
piled segment called 
path.eplbsa in the working 
directory, | 


savebsa the compiled segment, 
path,eplbsa, is left in the 
working directory and can 
| be assembled at a later time, 
gS % Used when EPLBSA is called 
after compilation (no nobsa option). 


Examp le: bop | >system_library_l>shortprogo errtty nobsa — | 
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BIND 


Format: 


Purpose: 


COMMANDS 
Perarenees Bxoon > 
bind path 


To bind together the object 
segments contained in the 
archive segment specified by 
path. Iwo entries are created 
in the user's working directory 
by the command: 
path - a bound segment . 
composed of all the 
segments from path.archive. 


path.map - map of the bound segment. 
The components of the archive segment 

must all be in object format and 

must have linkage and symbol sections. 


Assume alpha.archive is an archive 
file in the current working 
directory. Then 


bind alpha 
creates alpha and alpha.map, 


where alpha is the bound 
segment. 
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BR ANCH 


Format: 


Purpose: 


COMMANDS | 


Reference BX.8.06 
branch path 


To create an entry name in 
some directory. The entry name 
can be specified as either a 
directory name (terminated 

by >) or an non-directory 

name (no terminating >). In 
elther case the entry is 
designated as a branch. 


Append mode is necessary in 


the directory to which path 
1s to be added, 


See LINK command for creation 
of links, 


branch >user_dir_dir>dirl>dir2> 


where dir2 is the directory entry 
added to the directory 
path given as 


>user_dir_dir>dirl 
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COMMANDS 
CHANGE_WDIR Reference: BX.8. 4A 


Format: = change_wdir path 


Purpose: To change the name of the user's 
working directory to the 
pathname given by path. 


Examples: change_wdir >user_dir_dir>Stone. Multics 


change_wdir <Martin. Multics 
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COMMANDS 
CHASEPRATH Reference: BX.&.13 
Format: chasepath path 


Purpose: To retrieve the full and final pathname 


of the entry, path. 
Notes: | Read mode required in path. 
Examples: chasepath fred 


If fred is an entry in a directory 
branch of the working directory, 
>user_dir_dir>user, the example 
returns the character string: 


>user_dir_dir>user>fred 
If fred is a link to 
>user_dir_dir>other_user>fritz 
which is a link to 
>user_dir_dir>third_user>derf 


then chasepath returns the character 
string value: 


>user_dir_dir>third_user>derf 


To obtain the value at the terminal 
give the command 


echo [chasepath fred] 
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| COMMANDS 
CONTENTS Reference: MCB=275 
Format: contents path 
c path 


Purpose: To return as a character string the 
entire contents of the segment given 


by path. 


Notes: The command makes possible the execu- 
tion of a set of commands that have been 
typed into a segment, or the selection 
from a segment of a list of arguments 
to a command, etc. 


If a segment is to be used as a set of 
commands, then each command in the seg= 
ment must be separated from the next by 
a 3 eae) ea | 


There are two methods of delimiting the 
commands. which are to be executed. The 
First character and last character in 
the segment path can be [| and ] respec- 
tively, in which case typing: 


contents path 


is sufficient. In the second method, 
the user may type: 


[contents path] 


The segment path need not begin and end 
with square brackets if the second method 
is used. | oy ~% 


Example: Assume the following contents of seg= 


ment x: 
6 | abcd 


Then the command: 


remove ([contents x])(() «(link symbol) ) 


removes segments: 


a ~ aelink a.symbol 
b b. link b.symbol 
Cc c.link c.symbol 
d d. link d.symbol 
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COMMANDS. 
CONVERT OBJECT | ~ Reference: MCB-275 


Format: convert object path 


Purpose: [To convert path, path.link, and 
path.symbol to a single "ob ject" 


segment. 


Notes: If a text segment exists, an ob ject 
segment 1s created whether or not 
link and symbol segments are present. 
Either symbol only, or link and sym- 
bol may be missing. The command 
comments about missing segments. 


conver t_ob ject alpha 


If alpha was compiled in ep] with 
alpha, alpha.link, and alpha.symbol 
being created at that time, then the 
command will create a single segment, 
alpha.ob ject. 
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COMMANDS 
COPY Reference: BX.8.11 
Format: copy pathl path2 


_ Purposé? = To copy the branch entry, given by 
path? into the branch entry named 
in path2, thus creating the new 
branch. The entry pointed to by 
path2 must not exist before issuing 


the command. , 


Read mode is required for path]; 
write and append modes required 
for the directory containing path. 


The equals convention may be 
used, 


copy >old_dir>fred. link george.= 


Branch, fred. link, in the direc- 
tory, >old_dir, is copied into 
the working directory as 


george, link, 
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Format: 


Purpose: 


Example: 


COMMANDS 
CTSS_AARCHV | Reference: MCB=2775 


ctss_aarchv path>sepnamel. segname2 


To extract all segments from a CTSS 
ascl1 archive file and place them in 
the current working directory. 


seonamel and sepname2 are the first 
and second components of the CTSS file 


name. If path is not given, the 
CTSS archive file containing the 
seoment 1S presumed to be in the 
working directory. 


ctss_aarchv finds the real names of 
the segments if the archive file is an 
epl or eplbsa file and renames the 
extracted segments to their real names, 
or if the real names are not found, 
they are renamed to their CTSS name. 


To use the command for non-epl/eplbsa 
File, rename segname2 to epl or eplbsa. 
The resulting segments will have the 
Following name format: 

ctss_namel.epl — or 

ctss name 1.eplbsa 


eee TERR REPETITION pe 


ctss_aarchv alpha.eplbsa 
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DELACL 


Format: 


Purpose: 


Examp le: 


~ COMMANDS 
| Reference: BX,8,02 
delacl path acnamel ... acname 


To delete the access control names | 
acnamel_... acnamen, from the ACL of the 
entry defined by path or from the CACL of 
dir if path is terminated by dir>. 

path may be a path name, entry name or set 
of entry names defined by the * convention, 
acnamel_... acnamen each have the form: 


personal_name.project_name. tag 


where tag 1s the instance tag of the 
process-group in which user is currently 


working and is usually indicated by * for 


any Instance tag. An acname might be: 
Brown.Multics, * 


Omission of an acname argument causes an error 
comment. 


If an acname does not appear in the appropri- 
ate ACL, delacl prints a comment and processes 
the next acname. 


See setacl command for required access needed 
to delete access control names. 


delacl g_bcpl Doe.Multics.* Smith,Multics.* 


where g_bcpl 1s an entry in the user's 
directory. Access control names Doe.Multics.* 
and Smith.Multics.* will be removed from the 
ACL of g_bepl, 


delacl dir_bcpb Brown.Multics.* 


dir_bcpl is 4 directory within the user's 
working directory. Access control name 
Brown.Multics.* is removed from the CACL 
of dir_bepl. 


Restriction: Because delacl has not yet been imple- 


mented as described above, use the following 
format for deleting access control names from 
the CACL of a directory, some_dir. 
change_wdir >some_dir 

delacl "" acnames 
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DELNAME 
Format: 


Purpose: 


Example: 


COMMANDS 


Reference: BX.8.10 
delname path oe 


To delete an entry name specified 
by path. The entry specified by 
path must not be the only name on the 


entry. 


delname my_seg.list 


where my_seg.list is an entry name 
in the user's working directory. 
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~ DPRINT 


Format: 


Purpose: 


Notes: 


Examp le: 


COMMANDS | 
Reference: BX, 5,03 


~dprint path! path2 ... pathn 


To queue segments given by patht 
to pathn for delayed printing by the 
output driver daemon, 


The segments are copied onto the 
printer in the order given, 

Segments to be copied should contain 
Multics standard characters. Ifa 
segment 1s missing or has a zero 


length, the segment is skipped, 
dprint alpha beta >joes_dir>gamma 


Segments alpha and beta from the 
current working directory and 
segment gamma from joes_dir 
directory are queued for printing 
by the output driver daemon. 
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DPUNCH 


Format: 


Purpose: 


Notes: 


COMMANDS 
Reference: BX, 5.03 
dpunch path! pathe ... pathn 


To queue segments given by patht 
to pathn for delayed punching by the 
output driver daemon, 


The segments are punched in the order 
given. Segments to be punched 
should contain a binary card image 

in every 27 words, i.e., the 960 bits 
per card should reside in the first 
26-2/3 words of each 27 words. 

lf a segment is missing or has zero 
length, the segment is skipped. 


dpunch alpha beta >joes_dir>gamma 


Segments alpha and beta from the 
current working directory and segment 
gamma from joes_dir directory are 
queued for punching by the output 
driver daemon. | 
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ECHO 
Format: 


Purpose: 


- Examples: 


echo string 


COMMANDS tty, 
Reference: BX. 20.01 


A system test command. 
Echo types out "echo:" and a 
simple character string argument 


or a literal string argument or 


the character string value of a 
command argument passed to echo, 


echo abc 
echo: abc 


echo ab 
echo: a 


echo "a b cl! 
echo: abc 


echo [wdir | | 
echo: >user_dir_dir>Shih.Multics 
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EDM 


Formats: 


Purpose: 


Example: 


COMMANDS 


Reference: BX.9 
(Draft at present) 


edm path 


To invoke the EDM acer to create or 
edit an ASCI| segment, where: 


path is the optional pathname of a 
seoment to be created or the required 
pathname of an existing segment to be 
edited. If only the entry name is 
given, the segment is assumed to be in 
the current working directory. 


If path represents an existing segment, — 
the EDM editor begins in edit mode; 

if path represents a segment to be 
created (or if the argument is null), 
the EDM editor begins in input mode. 
see the section on EDM requests for 
further information on input/edit modes 
and how to use EDM. 


If the segment represented by path is a 


_ procedure for compilation or assembly, 


the name must include the name of the 
compiler or assembler to be used. 


edm testproc.epl 


The segment is in the current working 
directory (or will be created there). 
It will be an epl procedure invoked for 
compilation by: | 


epl testproc 
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EPL 


Format: 


Purpose: 


gS Notes: 


COMMANDS 
Reference: BX.7.08 


epl entry | 

To invoke the epl_ seen for ER 
compilation of the source seoment, 
entry, in the current working directory. 


When the epl_daemon is invoked, the 
r(eady) message printed at the terminal 
does not indicate that compilation is 
complete. To determine the results of 
compilation as well as to check as to 
whether compilation is COMpTCReGs the 


command 


print ep1_daemon. error 


will cause printing of results of 


compilation. A compilation-done 
message will be added at a later date. 


epl datanal 


where datanal.epl is the entry name of 
an EPL source program in the working 
directory. 3 
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EPLBSA 


ope: 


Purpose: 


Notes: 


Example: 


COMMANDS | 
Reference: BX.7.03 


elpbsa entry 


To invoke the epl_daemon for EPLBSA 
assembly of the source segment, entry, 
in the current working directory. 


When the epl_daemon is invoked, the 
r(eady) message printed at the terminal 
does not indicate that assembly is 
complete. . To determine results of 
assembly as well as to check as to 
whether assembly is completed, the 
command 


print epl_daemon.error 


will cause printing of results of 
assembly. (An assembly-done message 
will be added at a later date.) 


eplbsa my_sort 


where my_sort.eplbsa is the entry name 
of an EPLBSA source program in the 
working directory. 
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COMMANDS 


EXP AND Reference: BX.7.05 

Format: expand path mode pigeon 
Purpose: To insert into the segment, 

ath, additional segments speci- 

Fred in the text of segment path. 


| path is scanned for statements 
§ of the forms: 


% include pathnam 


where pathname is a segment 
to be inserted, 


Optional argument mode gives the 
access mode of the newly expanded 
path. (TREWA or any subset of 

the Trap, Read, Execute, Write 
and Append modes. ) 


Example: expand my_ep1l RW 


where segment, my_epl, in the 
user's working directory con- 
tains the following: 


my_epl: procs 
statement 1; 
% include Suser _dir _dir>joe_epl; 
statement2; 
% include Suser _dir_dir>make ep l; 
end my_ep]3 


The command causes segments, joe_epl 
and make_ep1l to be included as part 
of the newly expanded segment named 
my_ep leexpanded, | 
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| COMMANDS 
EXTRACT_ARCHI VE Reference: BX.99.12 


Format : Saat Avene path>segname1. segname2 


Purpose: To extract all segments from a CTSS 
regular archive file, and place them 
in the current working directory. 


seonamel and sepname2 are the first 
and second components of the CISS file 


name. If path is not given, the 
CISS archive file containing the file 
is presumed to be in the working 
directory. 


extract_archive finds the real names 
of the segments if the archive file 
is an epl or eplbsa file and renames 
the extracted segments to their real 
names, or if the real names are not 
found, they are renamed to their CTSS 


name. 


To use the command for non-epl/eplbsa 
File, rename segname2 to epl or eplbsa. 
The resulting segments will have the 
following name format: 
ctss_namel.epl or 
ctss_namel.eplbsa 


Example: § extract_archive alpha.epl 
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FH ELO: 


Format: 


Purpose: 


COMMANDS 
Reference: BX.5.02 


fileio path 


To indicate that the user's next 
input lines are to be taken from 

the segment entry, specified by path, 
not from the console. 


The format of input lines in path | 
must be the same as if they were to 
be typed at the console. 


When input from path is exhausted, 
the next input line is taken from the 
console, 


Fileio >my_library>sub_loop 


Input will be taken from sub_loop in 
the directory, my_library, until the 
end of the segment, 
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Example: 


COMMANDS 
Reference: BX.8.01 
files path | 


To obtain a list of path names 
of entries within path. The 
command differs from the list 
command in that the list is re- 
turned as a character string and 
path names rather than entry 
names alone are returned, 


print ([files *.epl ]) 


The files command is "nested" in 
the print command. When the 
files command is evaluated, the 
print command might be: 

print (a.epl b.epl c.epl) 


causing the three files to be 
printed, 
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FLUSH 
Format: 


Purpose: 


COMMANDS 
Reference: BX,20.03 
flush | 


To cause all pages currently 
In core to be paged out. A 
system test command; after 
flushing the system, worst 
case timings can be obtained 
for command execution, 
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FORTRAN 
Format: 


Purpose: 


Examples 


COMMANDS 


Reference: BX.7.02 
fortran path ‘ 


To compile and assemble the source 
program segment specified by path using 
the FORTRAN compiler. 


Fortran alpha 


where alpha.fortran is a source 
Program to be compiled and assembled. 
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COMMANDS 
FS_CHNAME - Reference: BX.8.16 


Format: fsichname path entry oldename newename 


Purpose: To cause one of the names of entry in 
the directory given by path to be 
replaced, deleted or added. This 
command interprets none of the special 
command symbols (e.g., *,>) and thus 
allows manipulation of strangely-named 
segments. 


When both the old entry name, oldename, 
and the new entry name, newename, 
appear in the command, newename 
replaces gldename. 


If oldename is the null string, "", 
then newename is added to the list of 
names for the entry. 


If newename is the null String, "|, | 
then oldename is deleted from the list 


of names for the entry. 


path must be a complete pathname 
relative to the root. 
Example: fs_chname >user_dirdir>my_dir alpha foo "" 
One of the names of entry alpha in 
directory, my_dir, was foo. This 
entry name is deleted by the command. 
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FS_READACL 


Format: 


Purpose: 


Examples: 


COVMANDS 
Reference: BX.8.17 


fs_readacl path entry 


To cause the access control list of 
entry to be printed. path gives the 
absolute (relative to the root) 

pathname of the directory containing 
entry. |The command interprets 

none of the special command symbols 
(e.9., *,>) and thus allows manipulation 
of strangely=named segments. 


If entry is given as a null string, 
1.e., "", the common access control list 
(CACL) of the directory given by. path 
will be printed. 


fs_readacl >user_dir_dir>my_dir alpha 


causes the ACL of segment alpha in 
directory, my_dir, to be printed. 


fs_readacl >user_dir_dir>my_dir ™ 


causes the CACL of directory, my_dir, 
to be printed. 
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COMMANDS | 
|OCALL 7s Reference: BX.5.01, BF.1.01 — 
Format: iocall outercal] ioname arguments 


Purpose: To issue |/0 outer calls from command level. 
~ outercall is one of the I/O outer calls. 
ioname is a name used to route calls in |/0. 


Pe arguments are other arguments of the given 
— gutercall. (Shown in table below. Hyphens show 


optional arguments. See BF.1.01 for argument 
information. 


Outercall loname Arguments 


attach 1oname type -mode- ioname2 

detach 10name =—mode— ioname2 

read 1oname worksegment -offset=- -nelem- 
write 1oname worksegment -offset— -nelem- 
seek 1oname ptrnamel -ptrname2—- -offset- 
tell 10oname = ptrnamel -ptrname2= 

setsize ioname elementsize 

getsize 10name | 


Notes: Calls to iocall should not be programmed into 
| procedures; use a call to outercall. 


Default input and output (called user_i/o) is 
to a console. Either input (user_input) or 
output (user_output) can be diverted using 
locall. | - 


Examples: iocall attach zz file made_up_name 


creates empty segment zz for subsequent at- 
tachment. | 


iocall attach user_output syn zz | 


attaches output to segment zz. A w(ait) mes- 
sage follows the call but no r(eady) message 
iS given until output is reattached to console. 


iocall attach user_output syn user_i/o 


reattaches output to the console. r(eady) mes= 
sage follows. - 


10call detach zz 


User detaches zz after reattaching output. 
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LINK 
Format: 


Purpose: 


COMMANDS 
Reference: BX.&.04 


link path1 path2 


To create a link to the entry 
specified by path! from the entry 
specified by path2. 


patht must include the directory 
as well as entry to enable the 
link to be made, 


~path2 may be absent. In that case 


a link is created in the user's 
working directory having the same 
entry name as that given in path1 


link >library>1saac 


makes a link entry "isaac" in the 
working directory. 


link >user_dir_dir>isaac >mydir>= 


makes link entry "isaac" in "mydir", 
link ([files >user_dir_dir>joe>**]) 


creates for each entry in the 


directory >user_dir_dir>joe a link 


entry of the same name in the 
working directory. 
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LIST 
Format: 


Purpose: 


Notes: 


Example: 


COMMANDS 
Reference: BX.&.01 


list path joname option 

To print out a list of entry names or a 
subset of the entry names in the direc- 
tory given by path. 

ioname is an optional name of an at- 
tached stream to which output is direc- 
ted. Default is user_output. When 
loname is given, diagnostics are given 
on both ioname_output and user_output. 


If option is not present, both branches 
and links will be printed. The possible 
options are: 


b = print branches only 
1 = print links only 


If an option is present in the command 
and no ioname is to be attached, a null 
string, "", must be given for joname. 

* and ** conventions may be used. 

list system_library>alpha. ** 

produces a list of branches and links 
that might be: 

Branches | 


alpha 
alpha. link 
alpha. symbol 


Links 


alpha. new >system_library_3_beta 
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LISTACL 
Format: 


Purpose: 


COMM ANDS 
| Reference: BX.8.03 
listacl path acnamel_... acnamen 


To print access control information on the 
entry name specified by path and users 
specified by acnames. If path terminates 
in >, information is printed from the 
directory's CACL; otherwise information is 
printed from the ACL of the entry name. 


acname has the form: 


personal_name.project_id.tag 
as in: Brown.Multics. qv 


listacl "" acnames prints the CACL of 
the working directory relating to acnames. 


listacl path ** prints access control in- 
formation on all users of path. 


If path specifies a directory or a branch in 
a directory, the user must have the read 


attribute on in the directory or branch. If 


Examp le: 


Restriction: 


path specifies a link, the user inust have the 
read attribute on in the entry to which the 
link eventually points and must also have the 
execute attribute on in the directory con- 
taining the link and all intermediate direc- 
tories linking to the ultimate entry. oe 


listacl >my_dir> Smith.Multics.* 
prints the CACL of my_dir for 


acname, Smith.Multics.* 


Because listacl has not yet been imple- 
mented as described above, use the 
Following format to list ACL information 
From the CACL of a directory: 


— change_wdir >some_dir 


listacl "" acnamel ... acnamen 
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COMMANDS 
LOGIN ; Reference: BX,3.01 
not yet published 
Format: | | login username project id 


Purpose: To gain access to Multics at 
command level after dialing into 
the system, 


username 1s the name of a user 
acceptable to Multics. 
project_id is the identification 
of the group with which the user 
is associated, Multics. 


Examp le: login Smith Multics 
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~ COMMANDS — 
LOGOUT Reference: BX.3.04 
Format: — logout | 


Purpose: ~~ To end communication with the 
Multics system, thus termin- 
ating a console session. 


Examp le: logout 


W 930:15.7 
smith Multics logged out 


The system responds to a logout 
with a W(ait) followed by the 
time of day to the tenth of a 
‘second. The system then indi- 
cates the logout is complete; 
the user's connection to the 
computer is broken and he must 
dial up and login in order to 
restore communication. 
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COMMANDS 


_ MERGE_EDIT ~ - Reference: BE.18,00 
ee BE, 18.01 


Format: merge _edit g path runname username options 


Purpose: To create an IMCV tape on Multics that can 
be run under GECOS, performing assemblies, 
etc., and producing a tape by which results 
can Bs returned to Multics. (See tape_in 
for returning results.) 


g path specifies the entry name of a 
merge _edit control segment used to select 
text for the IMCV, (See merge-edit con- 
trol lines section.) The second component 
of the g path entry name, if eter must 
be .gecos. 


runname is a 1 to 6 character primary com- 
ponent of the job name assigned the two 
tape_daemon control segments merge_edit 
creates in the wdir as intermediate output, 
1,€., a runname, jobx, creates two tape_ 
daemon segments: jobx.control and 
jobx.,control, binary. | 


username is a l to 12 character user name, 
options Two can be specified: | 
pipe /* do not signal tape_daemon*/ 


anes /* Run ape at Murray Hill or MAC / 


mac 


To notify tape_ daemon to execute control 
¢ ii segments produced by a previous merge edit 


the command is: 
- merge_edit runname (tape) 


where runname is that used in the previous 
command and (tape) is a literal 


Example: merge_edit comp2.gecos job2 Bennett mac 
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os COVMANDS 
MOVEBRANCH Reference: BX.8.12 


Format: movebranch pathl pathe2 


Purpose: To move a non-directory branch from 
one directory to another, deleting 
the original branch given by the entry 
name, pathi, (and the associated ACL) 
and establishing the new branch with 
the same entry name or anew entry 
name, given by path2 (with the 
associated ACL). 


Read and write modes are required in 
the branch to be moved. Write and 
execute modes are required in the 
directory of the branch to be moved. 
Write and append modes are required in 
the directory of the entry to be 
created. 


If path2 already exists, no move is done. 


A directory with inferior segments may 
not be moved, 


| The = convention may be used. 
Examples: movebranch >old_dir>fred.link joe.= 


The branch "fred.link" in directory 
">old_dir" is moved to the working 
directory and given the name "joe. Link". 
The entry "fred.link" in "old_dir" no 
longer exists. 


movebranch joe. link >old_dir>== 


The branch NJoeelink" in the working 
directory, is moved to the directory 
MOV OiG's 
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Example: 


COMMANDS 
Reference: BX.99.05 


mspeek path offset1 offset2 


To write onto the output stream, 
user_output, the octal representation 
of a selected part of a segment, given 
by path. offsetl and offset2 are 
character strings representing the 
starting and ending octal locations for 
the dump. 


mspeek my_seg 27 77 
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NEW_PROC 


Format: 


Purpose: 


Examp le: 


COMMANDS 


new_proc 


Creates a new process and leaves the 
user in the working directory he was 
in when he logged in. The old pro- 
cess is available for Yebugging but 
not for further processing. 


At present, new_proc causes the 
system to hang up the user. 

When he redials he will be in the 
new process, 


Assuming a quit has been made: 
new_proc 


creates a new process, leaving 
the user in his previous working 
directory, 
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NOTHING 
Format: 


Purpose: 


COMMANDS 


Reference BX.20.04 
nothing 


To provide a return giving 
minimal return time, thus 
aiding the interpretation of 
time needed to execute other 
commands. 
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~ COMMANDS 
PRINT Reference BX.9,.02 


Format : print path lineno endlineno 


Purpose: To cause an ASCI| text segment of 
entry name path, starting with the 
segment line specified by lLineno 

and ending with the segment line 
specified by endlineno to be writ- 
ten in the user's output stream 
"user_output", 


where: 


path is the entry or path name of 
the segment to be printed. 


lineno is an optional argument 
specifying the line number of the 
first line to be printed. If null, i.e, 
omitted or replaced with "" (2 double 
quotes with no space) or’ (balanced 
left and right accents with no space 
between them), in which case, the 
entire segment is printed, with a 
short identifying header. Must be 
used when endlineno is used. 

(Lineno may be a null string as 

above, or O or 1, or may be left off 
entirely if endlineno is also omitted.) 


endlineno is an optional line number 
of the last line to be printed; may be 
omitted or replaced with "" (2 double 
quotes with no space) or” (left and 
right accents with no space between 
them), in which case the segment is 
printed from lineno to its end. 


Assumes that new line characters are © 


appropriately embedded in the text. 
print my_seg2 7 9 


print my_seg3 
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PRINT DBRS 


Format: 


Purpose: 


COMMANDS a 
Reference BX.99.03 


print_dbrs 


To print out the values of 
the ring 0, 1, and 32 DBR 
settings of a single process, 
so that dumps of the process 
may be easily taken. 


Currently this command is called 
automatically at process 
Initialization, 
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| COMMANDS 
PRINT_LINK_INFO Reference: BX.9.05,BX.9.05A _ 


Format: print_link_info path file 


Purpose: To print linkage block information for entry 
path. Information includes: 


1) text segment length. 
2) <segment>|[symbol] names for each link pair 
| 3) list of entry point and segment definition 
@ names, giving ASCI| representation, octal 
value and symbol class. 
4) link pair list giving: a | 
a. address relative to linkage segment base 
b. <segment>| [symbol] to which a link 
points or self-reference. 
ce call pointer and argument pointer 
trap word if it exists. 


Presence of the optional literal file 
second argument causes the contents to 
placed in a segment, path.prink 


Example: print_link_info ps 


Segment >user_dir_dir>Garman.Multics 
Text segment length (in octal) 
Linkage block number 1 

Entry points and segdef names 

rs | Be entry point 

ps eh entry point 
symbol_table =O 

rel_text symbol 
rel_link symbol — 
rel_symbol | symbol 

Link pairs . 


10 _ <arg_count>lfarp count] , 
le. * | covestr ines heey 
14 : <write>! [write] | 
16 | <read>|[read | | 

20 <command_arg>|[return] 

22 *textlO,7 

1,0 | 2b Tbe] 
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PROBE 
Format: 


Purpose: 


Examp le: 


COMMANDS 


Reference: BX. 10.004 
probe 


To allow the user to enter the 
debugging system and issue a 
series of requests for debugging 
information, The command can be 
issued at an interruption of a 
command or at normal termination 
of a command, Probe requests 
produce information on one or 
more segments of the process, 


See section on probe requests for 
information that can be obtained. 


If a request issued after a probe 
command is not recognizable as a 
request, 1t 1s treated as a command, 


probe 
w 924:09.8 


System responds to probe command with 
a W(ait) followed by a hyphen. User 
types in the probe request immediate- 
ly following the hyphen. System will 
print out the requested information 
and then issue another ready-—for-re- 
quest (hyphen). User terminates probe 
with a quit request. 7 
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— COMMANDS 
QDUMP'7 og | Reference: BX.99.11 
Format: | - qdump7 path? path2 ... pathn 


Purpose: : To cause the segments given by 

| patht to pathn to be converted 
to 7-punch format and queued for de- 
layed punching by the output driver 
daemon, 


@....:: a If sa segment is missing or has a 
| | current length of zero, the segment 
is skipped, 


Example: © | qdump7 >user_dir_dir>Jay.Multics>comp 


causes segment, comp, from the 
directory given in the path to be 
queued for punching in 7=punch 
format. 
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COMMANDS | 
QED Reference: BX.9.06 
Format: qed input_file output_file 


Purpose: To create or to edit a text file using the 
QED editor. 


input_file is the input stream to QED and 
may be an entry name in the working direc- 
tory, a pathname to an entry in another 
directory, or can represent console input. 


output_file is the output stream from QED 
and may be an entry name in the working 
directory, a pathname to an entry in 
another directory, or can be output to the 
console. 


Notes: \f end-of-file is reached on an input file, — 
input switches to the console. 


See. section on QED requests for editing 
requests that can be used once QED is en- 
tered. 


Examples: qed | 
Input and output are from and to the console. 
qed my_file.bcpl 


Input is taken from my_file.bepi in the user's 
wdir and output is to the console. 


ged >joes_dir>epl13 my_file.epl _ 


Input is taken from epl13 in another user's 


working directory and output is to my_file.epl 
in the wdir, 


qed - my_eplbsa3.eplbsa 


Input is taken from the console and output 
is to my_eplbsa3.eplbsa in the wdir. 
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RE AD? 


Format: 


Purpose: 


ie 


Examp le: 


—read7 


COMMANDS — 7 
Reference: BX.99.09 


read7 rename 


To read 7=-punch card decks froma 
directly attached card reader into 
a segment with any valid pathname. 


The pathname of the segment is 
given on the header card of the 
deck, 


lf the literal, rename, 1s given as 


an argument to read7, the user is 
requested to give the new pathname 
from the console. If a pathname 
given on the header card is not | 
found, the user 1s requested to give 
a new pathname from the console. 


see reference MSPM section for 
formatting of the input deck. 


read7 


If it is not possible to attach the 
card reader, read7 1ssues a comment 
at the console. Otherwise, read7 
attaches a card reader on channel 
"rdrb38" and begins accepting 

card input. | (2 *% 
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Examples: 


COMMANDS 
Reference: BX.8.07 


remove path 


To remove a branch from the file system, 
where path terminates in the entry name 
of a branch. 


Write mode is necessary in the branch 
to be deleted and its directory. 


Remove refuses to remove a directory 
subtree (remove_dir must be used) or 
an entry pointed to by a link. 


remove seg] 


The branch seg! is removed. 
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COMMANDS 


- REMOVE_DIR 


Format: remove_dir path 


Purpose: To remove the directory specified by 
path and all segments inferior to it. 


Notes: Write mode is necessary for every 
branch to be removed and for the 
directory containing each branch. 


Example: -— remove_dir my_dir1 


The directory my_dirl in the working 
directory and all segments inferior 
to it are removed. 
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Examples: 


COMMANDS 
Reference: BX.8.08 


rename path entry 


To change the entry name specified 
by path to the name specified by 


entry. 


Write attribute must be on in user's 
working directory, Read attribute 
must also be on if the * convention 
is used, Both * and = conventions 
may be used in rename, 


rename >user_dir_dir>fred george 


where the result is renamed 
>user_dir_dir>george 

rename ([files *,ep1]) =.p11 

all two-component names with second 


component "epl" in the working direc-= 
tory are changed to have a second 


component "p11", 
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RUNCOM 


Format: 


Purpose: 


Notes: 


Example: 


COMMANDS 


runcom path argl ... argn 


To permit the user's next input lines 
to be taken from the ascii text seg- 
ment, specified by path, rather than 
from the console. argl ... argn are 
optional arguments to be inserted into 
the text of path. 


Each argument is inserted into the text 
of path as indicated by the include (&) 
Sign, followed by a decimal number, 


where: 


&1 is the first argument, 
&2 is the second argument, etc. 


runcom >my_lib>sub_loop fred george 


Assume the contents of sub_loop are: 
rename >my_lib>&l &2 | 

Then the input rom sub_loop is: 
rename >my_lib>fred george 


causing entry name george to replace 
entry name fred in the directory 


my_lib. 
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SETACL ~ 
Format: 


Purpose: 


Example: 


COMMANDS 
| | Reference: BX.8.02 
setacl path mode acnamel ... acnamen 


To modify access to the entry name specified 
by path for users specified by acnamel to 


acnamen. The new mode is given by mode and 


may be any combination of letters rewa (Read, 
Execute, Write Append). acname has the form: 


personal_name.pro ject_id.tag where: 


personal_name 1s a user name, e.g., Smith, 


project_id is Multics, and 

tag 1S an instance tage identifying the 
process-group in which the user is working. 
* (any instance tag) can be used. 

setacl path "" acnamel ... acnamen 


causes listed acnames to have no access to 


path. 


setacl path mode 


assumes acname 1s the personal_name of the 
invoking user and that tag is *. 


If path specifies a directory or branch ina 
directory, the user must have read, write and 
execute attributes on in the directory. If 
the user attempts to modify an ACL, given a 
link to it, the user must have, besides the 
access above, the execute attribute on in the 
directory containing the link and all inter- 
mediate directories leading to the branch. 


setacl my_dir>alpha re Smith.Multics.* 


gives read and execute access to alpha in 


my_dir to Smith. 


Restriction: Because setacl has not yet been imple- 


mented as described above, use the following 
Format to set access in the CACL of directory 
some_dir: 


change_wdir >some_dir 
setacl "" mode acnamel ... acnamen 
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START 


Format: 


Purpose: 


Examp le: 


COMMANDS 


ohare | 


To resume processing in the same 


process after a quit and at the 
point at which the quit was issued. 


User is in QED building an EPL 
program, 


User hits ATTENTION button on 2741 
once. | 
quit | | | 
r 1:11.2 25.3 53 /*system response*/ 
start /*User is now in QED at the 
point at which he issued the 


quit and can resume building 
the EPL program,*/ 


111-58 Rev 2 06019 


COMMANDS | 
STATUS fee Reference: BX.8.01 


Format: status path 


Purpose: To print detailed file status 
information on the branch or link 


specified by path. 
e°" status comp.err 


branch:>user_dir_dir_>Doe.Multics>comp.err 
unique id: BBDHg jgoWWF ZMh 

date used: 09/07/68 1424.4 EST Sat 

date modified: 09/07/68 1351.2 EST Sat 
branch modified: 09/07/68 1351.2 EST Sat 
mode: read 

bit length: 24192 

current blocks: 1 

maximum blocks: 23 

ring brackets: 32 32 32 


status lkx 

link: >user_dir_dir>South.Multics>lkx 
links to: >system_]ibrary>new_]l ink 

date link used: 09/07/68 1426.4 EST Sat 


date link modified: 09/07/68 1426.4 
BOT sat 
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: COMMANDS | 
~TAPELIN © | Reference: BX.99.02 


Format: tape_in reel_no seoment_list 


Purpose: To input into the user's working 
| directory the segments, given in 
segment list, which are taken from the 
CTSS 7=punch format tape whose reel 
number is given by reel_no. 


seoment_list is a list of CTSS segment 
name pairs, written in small letters, 
or the list may be designated as all. 
lf all is given, all segments on the 
specified tape are input. 


If the segments to be input were placed 
on the CISS 7=punch tape using the 
tape_out command, differences in the 
Multics and CTSS naming conventions 

may have affected the names of the 
seoments. See tape_out command. 


tape_in 144 all 


tape_in 201 epla text epla link eplb text 
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TAPE_OUT 


Format: 


Purpose: 


Example: 


COMMANDS 
Reference: BX.99.01 
tape_out reel_no path_list 
To write a tape containing segments from the 


Multics file system hierarchy onto a tape in 
CTSS disk editor (7-punch) format, where: 


reel_no is a tape identifier (name or number 


of the tape to be written). ser is used to 


designate any scratch tape. 


ath_list is a list of entry names of seg- 
ments to be written onto the tape. If the 
literal all is used in place of path_list, 


all segments in the working directory are 
written. 


If reel_no_is given without a path_list, a 
check is made to see if the control file 
with that identifier exists. If so, the ex- 
isting control file is used to write a tape. 


By CTSS/GECOS convention, all segment names 
have two components, each of which is 6 
characters or less. A single-component — 
name taken from Multics will be given a sec- 
ond component, TEXT. A Multics name having 
more than 6 characters in a given component 
is truncated to 6 characters, which are the . 
First three and last three of the original 


Name e 


- tape_out 25 alpha.epl beta epsilon 


epsilon.link 


The command produces on tape 25 four seg- 
ments taken from the user's working di- 
rectory and having the names: 

ALPHA EPL 

BETA TEXT 

EPSLON TEXT 

EPSLON LINK 
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COMMANDS 
TIME | Reference: BX,20.02 


Format: time 


Purpose: To print out five times a repre- 
| sentation of current time in octal, 
followed by that time converted 
into ascii representation, 


Example: time 
Output: 00000007442346 1650075004 


30 Jun 1500.47 EDT Sun 1968 
15:00:29.019652 
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| COMMANDS | | | 
UNLI NK | | Reference: BX,8.05 
Format: unlink path | 


Purpose: To delete the link entry speci- 
fied by path. 


Notes: Write attribute must be on for 
the directory containing the 
link, 


Examples: unlink fred_link 


where fred_link is a link entry 
deleted from the user's working 
directory, 


unlink ([files **]) 


all links in the working directory 
are deleted and error messages are 
printed for non-link entries. 
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WHO 


~ Format: : 


Purpose: 


Examples: 


COMMANDS 
Reference: MCB-275 


who usernamel...usernamen 


To determine what users are logged 
into Multics. | 


If usernames are given as arguments, 
Multics will indicate whether or not 
those users are logged in. 


who | 

a list of all current users will be 
printed out. 

who Meer Shih Spier 


an indication of whether one or more 
of the listed users is logged in will 
be printed out. 
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MERGE_EDIT CONTROL LINES 


bep 1 
core 
deck 
entry 
ep | 
ep lbsa 
error 
fetch 
insert 
libe 
load 
maket 1 
 notape 
pure 
symbo 1 
text+link 
tmg1 
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Merge_edit Control Segment Lines 


BCPL 


Format: 
Purpose: 


Default: 


Example of 
line: 


Merge-edit 
IMCV tape: 


bcp 1 dir>sourcesegment 
bc dir>sourcesegment 


To identify a bepl sourcesegment 
for compilation by BCPL. 


If dir is null, sourcesegment 
1S assumed to reside in the 
user's working directory, 


control segment containing bcp] control 
bcp 1 q_0 

load q_O 

Feteh “9.0% 


command to place bcpl program gq-O on 


merge-edit q.0 exl shore mac 
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Merge edit Control Segment Lines 


CORE 
Format: core 


Purpose: To obtain on-line dump of segments 
| having either the data option or 
woermt option, 


Note: See pure control line for dumping 
of all segments. 


Example: bepl q-O © 
load g-O wpermt 
core 
Fetch q-O * 
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Merge edit Control Segment Lines 


DECK 


Format: deck segnamel ... segnamen 


Purpose: To obtain punched decks of 
object code resulting from 
BCPL, EPL, EPLBSA, or IMGL activities or 
— maketl and text+link inclusions 
conducted on segnamel to 


seonamen. 


Default: If one of the segnamei is *, 
all object code generated 
from source segments in a 
given run will be punched. 


bep1 

bcp 1 

load 

load x0 

fetch q-O * x_O0 * 
deck q-0O 


merge edit q-O exl stone mac notape 


merge edit n-O ex2 stone mac 
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Merge_edit Control Segment Lines 


ENTRY 


Format: 


Purpose: 


Default: 


Examp le: 


entry segmentname entryname 


To specify an entry point for 
the start of execution of the pseudo- 


process, Segmentname is the name of 
an external segment and entryname 
1s the entry point within 


segmentname. 


If entryname 1s null, entryname 


1s presumed to be the same as 
segmentname, 


segomentname entryname in merge edit 


control line is equivalent to 
segmentname$entryname in EPL and 
to <segmentname> | [entryname] in 
EPLBoA, 7 | | 
ep! syzygy 

entry syzygy sunspot | 

load syzygy 

Fetch syzygy * 
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Merge_edit Control Lines 


EPL 


Format: 


Purpose: 


Default: 


Examp le: 


ep 1 directory»sourcesegment | 
e directory>sourceseoment 
ep1 sourcesegment 

e sourcesegment 


To identify a sourcesegment to 
be compiled by EPL. 


If directory is null, 
- gourcesegment 1s assumed to 


reside in the user's working 
directory, | 


epi syzygy 
load syzygy 
fetch syzygy * 
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_Merge_edit Control Segment Lines 


EPLBSA 


Format: eplbsa directory>sourcesegment 
eb directory>sourcesegment 
ep lbsa sourcesegment 


eb sourcesepment 


Purpose: To identify a sour cesegment to 
be assembled using EPLBSA. 


Default: If directory is null, 
sourcesegment 1s assumed to be 
in the user's working directory, 


Example: | 
eplbsa quirk 
load quirk 
fetch * * 
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| Merge edit Control Segment Lines 
ERROR ~ 
Format: |. error. 


Purpose: To cause the error segment to 
be printed on the on-line output. 


Note: An error segment is automatically 
| returned to the user if a fetch 
control line is in effect. 


Examp le: 


| ep lbsa quirk 
load quirk 
deck * 


error 
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Merge edit Control Segment Lines 


FETCH ' 
Format: fetch segi desc! ... segn desen 


Purpose: Fetches (returns) object (assembled) 
segments, placing entries for them 
in. the user's working directory, 


segi is the first component of a 

source segment name (CTSS name1) 

to be put in the working directory, 
If segi is *, all segments produced 

by compiler and assembler activities 

are fetched, 


desci is any character string or *, 
If *, text, link, symbol, and list 
segments are fetched, If desci is 
any other string, no list segment 
is returned, 


Note: If desci of the last segment is 
blank, text, link, and symbol 
segments are returned, 


Examples: EXAMPLE] _ | EXAMPLE2 
epl syzygy epl syzygy 
eplbsa quirk Se — eplbsa quirk 


load syzygy | : load syzygy 
load quirk load quirk 


Fetch syzygy m guirk * fetch * 


In example1, working directory entries 
are made for syzygy and quirk withtext, 
link and symbol segments returned for 

-each, A list segment is also returned 
for quirk, 


In example2, working directory entries 
are made and text, link, and symbol 
segments returned for syzygy and quirk, 


IV-9 Rev 2 06019 


Merge edit Control Segment Lines 


INSERT 


Format: insert dir>name_gecos 


Purpose: To insert a previously created 
merge_edit control segment, 
name_gecos, in the current 
control segment. 


When an insert line is encountered, 
control lines are read from 
name_gecos, When the final 


name_gecos line is read, control 


lines are again read from the 
current control segment. 


If dir> is null, name_gecos is 


assumed to be in the working 
directory, Nesting of insert 
lines is poae to a ~— 
of 9, 


Example: Control segment syzygy_gecos contains: 


epl syzygy 
load syzygy 
fetch syzygy 


_ This sequence of control lines: 
| ben 1. q.0: « 
load:.q:..0: - 


insert syzyBy_gecos 
Fetch g_O 


produces the following sequence of 
merge_edit control lines: 

bcp1 g_0 

load g_O 

epl syzygy 

load syzygy 

fetch syzygy 

Fetch q_0 
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LIBE 


Format: 
Purpose: 


Options: 


Example: 


Merge_edit Control Segment Lines 


libe segname options | 

li segname options 

To load a segment directly froma library 
file. | ; 

Option Meaning 

fO Directed fault O 

ft Directed fault 1 


7 Directed fault 7 
data hata segment 
slvorc Slave procedure 
exonly Execute only 
masprc § Master procedure 
slvacc Slave access 
wpermt Write permit 


Segment descripter bits are taken as the in- 
elusive OR of option bits. A descriptor con- 
taining fault 2 is created for a segment 
given slvacc. Options slvacce and wpermt are 
used only with other options, as in: 


Control Line | Bits 
libe prog1 slvacc, slvprc, wpermt 62 


Initial default option values are slvacc, 
slvpre. If a control line is encountered 
having other options, previous option values 
are cleared. The new values become default 
values for subsequent lines until changed. 


Segments called off library automatically, 
not requiring libe control lines: 


escape free_page_pool  f2cate 
get_put grow * init 

length library_dictionary linker 
messag newpag newseg 
relpag search : segman 
segpr_ tracerdatabase _ trunct 


eplbsa quirk | 
load quirk 
11 bin_oct 
fetch * * 
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Merge edit Control Segment Lines 
LOAD | 


Format: load sourcesegment options 


ld sourcesegment options 


Purpose: To cause the loading and execution 
of segments produced by BCPL, 
~TMGL, EPL or EPLBSA activity. 


Default: An asterisk (*) for source- 
segment causes all text, link, 
and symbol segments produced BCPL, 
TMGL and EPL compilations and 
- EPLBSA assemblies in the same run to 
be loaded. 


If options are null, options 
specified by the last load, 
libe, text+link, or maketl 
control line remain in effect. 
If no options were previously 
specified, default options are 
slvpre slvacc, 


Options: Options are given under libe 
| control line. 


Example: epl = syzgy 
eplbsa quirk 
load 
Fetch * * 
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Merge edit Control Segment Lines 


MAKETL 


Format: 


Purpose: 


Default: 


Notes: 


Options: 


Examp le: 


maket1 dir>entryname:segname options 
mk dir>entryname:segname options 


To cause a previously assembled 
text segment, entryname, in direc- 
tory, dir, to be loaded as segment 
segname, for execution, A dummy 
linkage segment is also loaded. 


If dir is null, the user's working 
directory is presumed. 


If segname is null, the text segment 
is loaded as entryname. 


If options are null, options speci- 
Fied by the last load, libe, 
text+link, or maketl control line 
remain in effect. If no options 
were previously specified, the 
default options are slvpre slvacc. 


If dir>entryname is *, a dummy 
text segment is loaded, 


Control line, text+link, loads a 
text segment with its actual linkage 
segment, 


Options are given under libe control 
line, 


maketl spasm 
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Merge edit Control Segment Lines 


~ NOTAPE 
Format:  notape — 


Purpose: To suppress the creation of a return 
tape by GECOS, overriding a fetch control 


line, | 


Notes: This control line differs from the 
| notape argument in the merge—edit = 
command, The argument prohibits 
Multics from making an IMCV for input 
to GECOS: the control line causes GECOS 
to suppress creation of a return tape. 


Examp les 
epl syzygy 
load syzygy 
deck * 


notape 
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Merge_edit Control Segment Lines | 


PURE 
Format: pure 


Purpose: To obtain on-line dump of 
all segments if a core control line 
is also included. 


See core control line for 
on-line dump of data and 
write-permit segments only. 


Examples: epl = syzygy 
load = syzygy 
pure 


core 
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Merge_edit Control Segment Lines 
SYMBOL 


Format: symbol 


Purpose: To cause the symbol segment 
of all segment groups named in 
text+link control lines to be 
loaded. If this line is absent, 
only text and link segments will be 
loaded. 6 


Note: See text+link control line. 
Example: tl spasm 


symbol 
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Merge_edit Control Segment Lines 
TEXT+L INK 


Format:  textt+link dir>entryname:segname options 
tl dir>entryname:segname options 
tl dir>entryname options 


Purpose: lo cause a previously assembled 
text segment, entryname, in directory, 
dir, to be loaded as segment, 
segname, for execution. The 
associated linkage segment is also 
loaded. 


Default: If dir is null, the user's working 
directory 1s presumed. 


If segname 1s null, the text segment 
is loaded as entryname. 


If options are null, options specified 
by the last load, libe, text+link, 

or maketl line remain in effect. 

If no options were previously 
specified, default options are 

slvpre slvacc. 


If dir>entryname is *, a dummy text 


segment is loaded, 


Options: Options are given under libe control 
line. 


Note: Control line, maketl, loads a text 
segment and a dummy linkage segment. 


Example: tl spasm 
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Merge edit Control Se 


INGE | ee 
Format:  tmgl dir>sourcesegment 


Purpose: To identify a sourcesegment 
for compilation by TMGL. 


Default: If dir is null, sourcesegment 
. ¢ is assumed to be in the user's 
working directory. 


Example: tmgl scan 
load scan 


fetch scan * 
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| EDM Requests 
BACKUP : - 


Format: =n 


Purpose: Move pointer back up the seg- 
ment the number of lines 


specified by the integer n. 


Spacing: A blank is optional between 
the request and the integer | 
argument, 


Default: If n is null, the pointer 
1S moved up one line, 


Example: 


Before: a: procedure; 
X= y3 
q= 13 
s= t; 
end a; 
—2 
a: procedure; 
x zy; 
= GE rs 
s= t;- 


end a3. 
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EDM Requests 


BOTTOM: b 


Format: b 


Purpose: | Move pointer to end of segment 
and switch to EDM input mode. 


Pointer: Set after last line in file. 
Examp le: 


Before: : procedure3 
x 


q 
S 


Request: b 


After: a: procedure; 
x 
q 
S 
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EDM Requests © 
CHANGE : 


re i ie x! 
Format: cn/string1/string2/ — 
Purpose: Replace string by string2 in the | 
| number of lines indicated by integer n. 
EDM responds to each change by printing 
the line with the changed text in red 
if the user is in VERBOSE mode. 


Delimiters: Any character not appearing in string’ 
or string2 cam delimit the strings 
(/ is shown in the format). Delimiter 
following string2 is optional. A 
space before n and between n and the 
strino1 delimiter is-optional. 


Default: —s«IF integer is absent, only string] 
| of the current line is changed. 


If string1 is absent, stringe 


is inserted at beginning of line. 
Pointer: Set to last line changed. | 
Example: 
Before: ~> at procedure; 
X= Yo 

eas 
SS 
end a3 


Request: c2/./; 


Response: x = y3 
one 


8 After: a: procedures 
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EDM Requests 


DELETE 
Format: n 


Purpose: Causes the number of lines 
given by the integer n to 
be deleted. Deletion begins 


at the current line. 
Spacing: A space is optional between d and 6 
the integer. | 


Default: If n is null, the current line 
is deleted, 


Pointer: Set to first line following the — 
lines deleted. 


Example: 
Before: a: pRoceanne) 
> y3 
r5 
tj 


as 
Request: d 2 


After: a: procedure: 
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| | EDM Requests 
FIND »#&£f | 
Format:  f string 


Purpose: Search segment for line beginning with 
string. Search starts at line following 
the current line and continues around the 
entire segment until string is found or 
until return to current line. The current 

line is not searched. 
If line is not found, an error message, NO, 
1s printed in red. if the line is found 
and user is in VERBOSE mode, the line is 
printed. 


— Spacing: A single blank following f is not signi- 
| Ficant; all other leading and embedded 
blanks are used in searching. 


Default: If string is null, EDM searches for the — 
, string requested by the last f or 1 
request. 
Pointer: Set to line found or remains at current © 
line if the line is not found. 


Example: 4 (first character position) 
Before: | a: procedure; 
-> xX = Y3 
SSS... 


end a3 


Request: Ff +t (note blanks for character 
| positions) | 


Response: NO 
Request: f s 
Response: s = t; | (VERBOSE mode) 
After: a: procedure; 
Xx = y3 
-> SS us 
end a3 


V-7 Rev 2 06019 


EDM Requests 
INSERT: — i | | 
Formats: | i newline 


Purpose: Insert newline after the cur- 
| rent line, 


Spacing: First blank following i is not 
significant. All other leading 
and embedded blanks become 
part of the text of the new 
line. 


Default: If newline is null, blank line 
1s inserted, 


Pointer: Set to the inserted line. 
Note: _ Immediately after a t+ (TOP) 
| request, an 1 request causes 


the newline to be inserted 
at the beginning of the segment. 


Examp le: | | 
Before: (first character position) 


: procedure; 
x =¥% 
q= 15 
| -> ae 
Request: i end a; 
JAP ters a: procedure; 
xX = ¥3 
q= 05 
SS ts 
—> end a; 
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EDM REQUESTS 
k 
sees 
To inhibit EDM from printing 
out responses following an f, 1, 


or c request. The EDM system 
default is VERBOSE mode. 


Pointer: Unchanged. | 
Note: See v (VERBOSE) request. 


Example: 


Request:  v 
edyf 
Response: y = 23 


Request:  k 
A ede 


No response 
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| EDM Requests 
LOCATE: : l 


Format: | ] string 


Purpose: Search segment for line containing 
string. Search starts at line fol- 
lowing current line and continues 
around entire segment until string | 
is found or until return to current 
line. If the line is not found, an 
error message NO is printed out in 
red. If line is found and user is 
in VERBOSE mode, the line is printed. 


Spacing: Single blank following 1 is 

| not significant. All other 
leading and embedded blanks 
are used in searching. 


Default: If string is null, EDM 
, searches for the string re- 
quested by the last 1 or f 
request, 


Pointer: Set to line found or remains 
at current line if line not 
found. 


Examp le: | 
Before: — a: procedure; 
x= y3 
yo seer 
=? -, S-=es 
end a; 
Request: ee — 


After: | a: procedure; 
=P y3 
rs 
t5 


a5 
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EDM Requests 
NEXT: fa n 
Format: onan | 
Purpose: © Move pointer down the segment 


the number of lines speci- 
fied by the integer n. | 


Spacing: ~ Blank optional between n 
and the integer. 


Default: — If integer n is null, the 
pointer is moved down one 
line. 


Examp le: 
Before: a: procedure}; 
| = 3 
-> - 
a5 


Request: — 


After: : procedure; 
a Y3 
r5 
t3 


a5 
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EDM Requests 
PRINT: p 
Format: pn 


Purpose: | The number of lines specified 
by the integer n will be 
printed out beginning with 
the current line. 


Spacing: A blank is optional between 
| p and the integer. 


~ Default: If nis null, the current 
line is printed, 


Pointer: Set to last line printed, 
Examp le: 


Before: a: procedure; 


Y3 
-> r3 


Request: 


_ Response: 


After: a: procedure; 
= 
qG=T; 
ee 
a5 
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| | EDM Requests 
QUIT: Q 
Format: | q 


Purpose: Terminate EDM editing without 
saving the edited copy of the 
segment. 


Notes To save segment, see s (SAVE) 
| request. , 


Examp les 


Oldfi les a: procedure; 
, ae 
5 


n 


| | e 
Request: | c /3/ (ysr)3/ 


Request: 


| p 
Response: a: procedure (y,r); 

< 

at 


Newfiles— procedure; 
Original 
(unedited) 
file is 
retained. | 
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aa EDM Requests 
Rel vees r 


Format: — r newline 


Purpose: _ Replace current line with 
newline. 


Spacing: _ One blank between r and 
newline is not significant, 
All other leading and embed- 
ded blanks become part of 
the text of the new line. 


Default: If newline is null, a blank 
line replaces the current line. 


Pointer: Unchanged. 
Examp le: 
Before: a: procedure}; 
—> X= y¥3 
oa ae 
s= t3 
end a; 
r del (r,t) float bin (27); 
a: procedure} 
-> del (r,t) float bin (27); 
Gir Ey 
s= t; 
end a} 
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SAVE: 
Format: 


Purpose: 


Spacing: 


Default: 


Note: 


Example: 
Oldfile: 


Requests: 


Newfile: 


EDM REQUESTS | 


S 


Ss path | 

To terminate EDM editing and 
save the edited copy. path can 
give the directory and the entry 


name within the directory under 


which the segment is to be saved. 
If only the entry name for the 


saved copy is given, the working 
directory is assumed. 


A blank between s and path is 


not significant. 


If path is null and if the origi- 
nal name of the segment is not null, 
the edited segment is saved under 
the original name; the original seg— 
ment is deleted. If path is null 
and no previous segment exists, an 
error message is printed and EDM 
looks for another request. 


To terminate editing without 


saving the edited copy, see q 
(QUIT) request. 


a: procedure; 


o/'3/ (ysr)3/ 


a: procedure (y,r); 
Edited 
ee ae Ge 
retained. 
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Sie 
Format: 


Purpose: 


tars 


Note: 


Examp le: 


Before 


Request: 
Afters: © 


EDM Requests 


g 


t 


Moves pointer to first line 
of segment. 


At first line of text, 


An i (INSERT) request immed— 
lately following a t request 
causes insertion of a text 


line at the beginning of segment. 


See INSERT. 


: procedure; 


procedure; 
x = 
2 | = , 
6 21; 

end a3. 
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VERBOSE: 
Format: 


_ Purpose: 


Pointer: 
Note: 


Example: 


Before: 


Requests: 


Response: 


After: 


EDM REQUESTS 


V 


V 


Causes EDM to print out 


responses following anf, l, 
or c request. The default 
EDM mode is VERBOSE, 


Unchanged. — 


See k (KILL) for inhibiting 


VERBOSE mode. 


a: procedure; 
X= ys 
—- qH=Pr3 
ss= T; 
end a; 


a =/ 


s = t; 


a: procedures; 
oe 
5 
a; 


V-17 Rev 2 06019 


ae QED REQUESTS 
REQUEST MEANING | REQUEST 
absolute line address 
append 
buffer 
change 
current line address 
delete | 
enter 
exclude 
global 
insert 
list 


MOVE 


print | 


quit. 

read 

sort — 
status 
substitute 
transform 


write 
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QED REQUESTS 


QED EDITOR 


The ged editor performs operations on text ina 
working space called a buffer. A buffer contains 
zero to any number of lines of text, and there may 
be any number of buffers. Each buffer is identified 
by a name. There is one current buffer; all other 
buffers are auxiliary buffers. 


BUFFER NAMES 


The buffer name can be any length but only the 
last five characters are significant. Generally, 
buffers are named with a one to five character 
name enclosed in parentheses. If the name is 

one character long, and not a carriage return 

Or apostrophe, the parentheses can be omitted 
(e.o., buffer names X and (X) are identical.) 


TEXT ADDRESSING 


QED accepts commands and text as a stream of 
characters from the console. Text within the 
current buffer is specified by (1) line addresses 
or (2) strings (regular-expressions) in the text 
line. 


Lines in the current buffer may be addressed in 
the following ways: 
1. by current Line number 
7 A decimal number not beginning with "O" or an 
octal number beginning with "0" is interpreted 
as a current (relative) line number. The first 
line is numbered 1, the second 2, the tenth line 
10 or 012, etc. This number may change dur ing 
editing. Example: 

3,6 p a 


means print lines 3 to 6, inclusive. 
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ee ts, 278 QED REQUESTS 
TEXT ADDRESSING (CONT.) | 
2- by absolute line number 


The character ' (apostrophe immediately 
followed by a decimal number (or octal 
number beginning with "0") is interpreted 
as an absolute line number. This number is 
assigned to each line in the current buffer 
when the text is initially read into the 
buffer from a segment. These line numbers 
never change except after read requests 
(which cause a new set of absolute line 
numbers to be assigned to text in the 
buffer). New lines created during editing 
have undefined absolute line numbers. 
The character "'" not followed by a digit 
causes a search for the first undefined 
absolute line after the current line. 
(The search is cyclic from the line after 
the current line to the current line.) 
If there is no line with the given 
absolute line number an error message is 
printed on the console (see "Diagnostics"). 
Example: 


15> 


means print the text on the line designated 
by absolute line number 53. | 


by the value of the current line (CL ee 


~The character ".". (period) in a QED address 

means the value of the current line. This 
value is changed by most edit requests. 
Example: 


*p | 
means print the current line. In the 
examples provided for each request an 
arrow (<=) indicates the position of "." 
(the value of the current line). 
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~ TEXT ADDRESSING (CONT.) 


he 


QED REQUESTS ~ 


e spec; ar ep! 
The value of $ in an address is the last line 
of text in the buffer. This value may change 
during editing. Example: 


1,$ p 


means print all lines from line 1 to the last 
line. 


ontext 
The string,/regular expression/, causes a 
search by QED to match r i" ression in 
the text. The search begins at the line 
after the current line and cycles to the 
current line. If the search is successful, 
the first occurrence of r id t LO 
(in the direction Sarched) has been located. 
Example: 


/x=2y/ p 


causes the first line of text containing 
"x=2y" to be printed and causes "." (current 
line pointer) to be set at that ine. 


by addi 

An address Followed " + or = followed 5 
another address (normally relative line 
number or regular expression) can be used to 
address a line. 


LO+4 p print line Bie 


/xyz/-5 print a line five lines before the 
line containing the regular 
expresslon, XYZ. 
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| | QFD REQUESTS 
REGULAR EXPRESSIONS 


Conventions used in writing regular expressions in 
QED can best be shown by examples. These are: 


/a/ matches letter "a" anywhere on a line. 

/abcd/ matches string "abcd" anywhere on a line. 
/ab*c/ matches strings "ac", "abc", "abbc", "abbbc", ... 
Jabcldef/ matches string "abc" or string "def". 
/(ilo)nto/ matches strings "into" and "onto". 


—|In addition, the characters '"™", ".", and "$" have 
special meaning. The character " " matches the 
zeroeth character on a line. The character "$" 
matches the character after the last character on a 
line. The character "." matches any character on a. 
line. For example: : 


/.*/ matches an entire line regardless of length. 

/~begin|end$/ matches a line beginning with "begin" 
or ending with "end". 

/in.*to/ matches a line containing "in" and "to" in 

| that order. 

/“beg.*end$/ matches a line starting with "beg" and 
ending with "end". 

/*$/ matches a blank line. 

/$VY is an illegal combination matching nothing. 


TEXT INPUT 


A number of QED requests are followed by literal text 
input. This text must be preceded by a space or a 
carriage return. The text consists of any string of 
characters terminated by \f. The Nf is not part of 
the text but delimits end of text; \f is used at the 
beginning of the next line following the last charac- 
ter in the body of the text. 


ESCAPE CHARACTERS | 
Standard Multics escapes are used. See INPUT STREAM 


section. 
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QED REQUESTS 
DIAGNOSTICS 


Regular Expression search failed. 
Unrecognized request or address. 
Regular Expression syntax error. 
Address syntax error. 
Address wrap around. 
Address out of buffer. 
Abs line search failed. 
File system error. 
Request syntax error. 
Unknown Regular Expression type. 
— Out of memory. 
Overflow on store. 
Passed EOF on store. 
Free of block 0. 


(Diagnostics 16 to 20 are fatal.) 
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QED REQUESTS 
ABSOLUTE LINE NUMBER 


Format: adriz. 
/regular_expression/: 

Purpose: Prints absolute line number of 
the line addressed. 

"." value: set to the addressed line. 


Note: If the absolute line number is 
undefined, a "?" is typed. 
Example: | 
Buffer Contents Absolute line number 
xX = y3 | 
if y<10 toe 
GO TO PROCA; eo, 


Requests: 
/<10/d 
/PROC/: 

Results: 
oo 


Even though line 52 is deleted the 

absolute address is the same as it 

was when the line was created, i.e., 

absolute lines are not changed by 
editing. 
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QED REQUESTS 
~ APPEND a 


Format: adra or /regular_expression/a 


text _ text 


\F fs AG 


Purpose: To append text after the line 
addressed, 


"," value: Pointer set to last line appended. 
; If no lines were appended, "." is 
set to the line addressed. 


Default: ais the same as .a 
Examp le: | 
Before: 


a: procedure; — 
X= ye 
end a; 


Request: 


procedure 
xX = y3 
q= FP; 
end a3 
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ED REQUESTS 


BUFFER b 
Format: bx 
where x is the name of a buffer. 


Purpose: To make the current buffer an 
auxiliary buffer, and to make 
x the current buffer. If buffer 
x does not exist it is created. 


Initially, buffer O is the 
current buffer. 


"." value: Line pointer unchanged in each 
buffer. 

Example: 
Before: 


Buffer 2 is the current buffer. 
"." is at line 2 in buffer 2. 


Buffer 3 was previously the 
current buffer; at that time, 
"." was at line 3 in buffer 3. 


Request: — 
b3 
After: 


Buffer 2 1s an auxiliary buffer, 

and buffer 3 1s the current 
buffer. "." in buffer 3 is 

at line 3. 


If the request b2 is issued later, 
buffer 2 will be the current 
buffer, and "." will be at line 2 
in buffer 2. 
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CHANGE 


Format: 


Purpose: 


Default: 


Note: 


Example: 


QED REQUESTS 


tex 
\f | | 
To delete the lines specified by adr1 


through adr2 and to substitute (input) 
other text for the deleted lines. 


(The line number specified by adr1 must 


not exceed adr2.) 


: Line pointer is set to the last line of 


the text. If no lines of text are substi- 
tuted (input), "." is set to the line 
before the first line deleted. 


adric is the same as adri,adric 
c 1s the same as .c 


adr2 must be preater than or equal to adr 
(i.e., the addressed lines cannot cross 
zero cyclicly.) 


Before: 
7 a: procedure; 
Kay; 
se 
end a3. 


procedure Line 
t3 Line 
V3 Line 
Zs Line 
as - Line 
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QED REQUESTS 
CURRENT LINE NUMBER = 


Format: §_ /regular expression/= | 
Purpose: Prints current value of a line. 
"," value: Set to the addressed line. 
Default: = is the same as $= 
Example: a | 
BUFFER CONTENTS CURRENT LINE NUMBER 
A:procedure;3 | 0001 
declare x fixed bin(17)3 —. 0002 
~ g=bs | | ? ~ 0003 
| 0004 
Q005 
| 0006 <- 
The current line is line 6 and the request: 
causes: 


0906 


to be printed at the console, and the value 
of "." remains at 0006. , 


Similarly, the request: 
ja = | 
causes: 


OO4 to be printed at the console and the 
value of "." 1s set to OOO4. 
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QED REQUESTS 
DELETE 


Format: 


Purpose: To delete the lines specified by 
adri through adr2. (The line 
number specified by adr1 must 
not exceed adr2. ) 


"." value: Line pointer is set to the line 
after the last line deleted. 


Default: adrid is the same as adri,adrid 


d is the same as .d 


Note: adr2 must be greater than or equal 
| to adr1. (i.e., the addressed lines 
cannot cross zero.) 
Example: 
Before: 
ai procedure; Line 
xX = y3 7 Line 
qQ=r3 Line 
eae Line 
end a3 Line 
Request: - 


(3,40 /o/,/s/¢ 
After: | 
a: procedure; — Line 1 
x = y3 Line 2 
end a; Line 3 <- 
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QED REQUESTS 
ENTER e 


Format: e/regular expression/name/ — 


Purpose: Jo tag a regular expression 
with a specified name. If the 
same name is used in several 
ENTER requests, the most recent 
request takes precedence. 


Examples: 


In sequence A; the SUBSTITUTE request 
replaces regular expression, henry with the 
string, aldrich. In sequence B, the 
SUBSTITUTE request replaces regular expres- 
sion whose tag is henry, i.e., alpha, with 
the string, aldrich. < > symbols indicate 
that the string enclosed is a tag. 


Sequence A | sequence B 
Buffer Contents: Buffer Contents: 


alpha = henry; alpha = henry; 
| Request Sequence: Request Sequence: 


e/alpha/henry/ ~ efalpha/henry/ 
s/henry/aldrich/ | s/<henry>/aldrich/ 


Buffer Contents: Current Line: 


alpha = aldrich; — aldrich = henry; 
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QED REQUESTS 
EXCLUDE V , | 
Format: adri,adr2vrequest request parameters 
Purpose: To execute request on all lines not con- 


taining regular expression. 


The following are the only legal construc- 
tions for the exclude request: 


adri,adreva text/regexp/ | append 
adri,adr2vc text/repgexp/ change 6 


adri,adrevd (ESESe/ delete 
adri,adrévi text/regexp/ | insert 
adrit,adr2vm bufnam/regexp/ move 


adri,adr2vp /regex rant 


P 
adri,adrevs /regexp/string/regexp/ substitute 
adri,adrevy /string/string/ transform 


adri,adrev: /regexp/ absolute line 
adri,adrev= /regexp/ current line 
"." value: Pointer is set according to the request. 
Default: vrequest request parameters is the same as 
| 1,$vrequest request parameters 


Note: Because of the nature of the exclude re- 
/ quest, the request parameter, regexp, 
is required for the move request. 


Example: Before: 


Request: 1,$vp/d/ 
Result: ef gh 
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~ GLOBAL 
Format: 


Purpose: 


"value: 
Default: 


Note: 


Purpose: 


go | | 
adr1,adr2srequest request parameters 

To execute a given request on all lines 
addressed. 


The following are the only legal construc- 
tions for the global request. 


adri,adr2o9a text/regexp/ “append 


adri,adr2o9c text/regex change 
adri,adr20d /regex : delete 
adri,adr2oi text/regexp/ insert 


adrt,adr2om bufnam/regex move | 
adri,adreop /regexp/ — print | 
adri,adrzos /regexp/string/regexp/ substitute 


adri,adr2sy /string/strin _ transform 
adri,adr29: /regex absolute line 


~adri,adr2o= /regexp/ current line 


Pointer is set according to the request. 


grequest request parameters is the same as 
1, %grequest request parameters | 


Because of the nature of the global request, 
the request parameter, regexp, is required 
for the move request. 


Before: 


Request: s$op/d/ 
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INSERT 


Format: 


Purpose: 


"." value: 


Default: 


Example: 


QED REQUESTS 
i 
adr1 1 text 
\f 


QED accepts text which is inserted 
before adri in the current buffer. 


Line pointer is set to adri. 
1 text 

\f 

is identical to: 


~1 text 
\f 


Before: | 
BUFFER CONTENTS RELATIVE ADDRESS 
a: procedures 1 

X= y3 A 
enda3s <= 3 
Request: 
D1 
ea OF | 
if x = b then y = a3 
* 
After: 


BUFFER CONTENTS RELATIVE ADDRESS 


a: procedure; 
xX = y3 
a = "be 
if x = b then y = a; 
end a3 <- 
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te" value: 
Note: 


Example: 


QED REQUESTS 
l oo 
1 type segnam 
To read and print the Multics 
segment specified by segnam. 
Only one type is currently recognized; 
this 1s: | 

<sp> ascil 


therefore, the type parameter is 
is left null. 


is unchanged 


A space must appear after 1. 


The segment, joe.ascii, is a Multics 
seopment in the working directory of 
the user. : 


Request: 1 joe.ascli 


The contents of joe-ascii are 
then printed out on the console. 


Result of request: 
test: proc; | | 
| <a contents 
y = xt]; of 
end test; Joe-ascli © 
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QED REQUESTS © 


m 
a 


dr1,adr2mx 


To replace all the contents of buffer x 
with lines from the current buffer from 
-adri1 to adr2. adr1 must be less than 
adr2. adri through adr2 are deleted from 
the current buffer. The MOVE request 
causes buffer x to become the current 6 
buffer. If buffer x is already the cur- 
rent buffer, all contents of x except lines 
specified in MOVE are deleted. 


"." value: Line pointer 1s set to the line after the 
last line moved in the current buffer and 
set to the last line moved in buffer x. 


Default: adrimx is the same as adr, adr1mx 
mx 1s the same as .mx 
Example: — 
Before: 
CURRENT BUFFER L BUFFER K 
a: proc; Line l c: procs; Line 1 
b= C3. (Line 2 jJ = ks Line 2 
e: proc3 Line 3 end c3 Line 3 
f = g3 Line 4 
end e; Line 5 
end a; Line 6 


Request: 3, 5mK 
Afters — 
BUFFER L : CURRENT BUFFER K 


a: proc; Line 1 e: proc; Line l e 
b = c3 Line 2 t = 103 Line 2 | 
end a; Line 3 end e; Line 3 
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QED REQUESTS 
PRINT p | 
Format: —S_ adr i, adr2 


Purpose: To print the lines specified by adr1 
through adr2. (The buffer is un- 
changed. 
"\." value: The line pointer is set to the last 
line printed. 


Default: adrip is the same as adri,adrip 
p is the same as .p 
adr1 followed by a carriage return is 
the same as adrip 7 


Hitting the carriage return 
peints the current line. 


/regular expression/(cr) prints the 


first line in the buffer (after the 
current line) which contains the 
regular expression. 


E : 
ane Contents of Current Buffer: 


a: procedure; Line 1 
y3 Line 2 
r3 Line 3 
t: Line 4 
as Line 5 


Request: 2,40 or /x/,/s/p 
Result: 
The following is printed: 


X= y3 
q+ F}3 
s= t; 
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QUIT 
Formats 


Purpose: 


Note: 


UD REQUESTS 


q 
q. 
To return to Multics command level; 


or to return from QED to the process 
which called QED. 


The q request does not determine 
whether or not the buffer is saved. 
To save a buffer, the contents 

must be written into a Multics seg- 
ment using either the w (WRITE) 
request or the optional argument 

in the QED command, output_file. 
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READ 
Format: 


Purpose: 


"Ly" values 


Default: 


Example: 


QED REQUESTS 


r | 
adrir type segnam 


To read the Multics segment whose name 
is specified by segnam and to append the 
segment after the line addressed. A 
space must appear between r and type. 


Only one type is currently oe 


T 
naa <sp> ascii | 


Therefore, the type parameter may is null. 


Line pointer is set to the last 
line read. | 


r type seopnam is the same as 
$r type segnam 
Before: 

a: procedure; 


x = y3 
end a; 


Request: 
2r joe.ascil 
where joe.ascil 1s 
b: procedure; 
G-= a; 
end b; 
After: 


a: procedure} Line 
xX = y3 Line 
b: procedure; Line 
C= ds Line 
end bs _ Line 
end a3 Line 
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SORT 
Format: 


Purpose: 


"Le" value: 


Default: 


Example: 


QED REQUESTS 


dri,adr2k 


To sort the lines specified 

by adr1 through adr2 in ascending 
ASCI| collating sequence. adr 
must be less than adr2. 


Line pointer is carried with the 
sorting; it may change value but 


it points to the same line of text. 


adrik is the same as adri,adrik 
k is the same as 1,$k 


Current Buffer Before: 


alpha beta gamma <= 
abcde — 
bcdef 

bdcef 

ZXYWX | 

zabcd 


12345 

Request: k 

Current Buffer After: 
12345 


abcde , , 
alpha beta gamma <- 
bcdef | 

bdcef 

zabcd 

ZX ywx 
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"oe" value: 


Example: 


QED REQUESTS 


To cause the following information 
to be listed: | 


Name of current buffer. 
Value of "." (current line). 
Length of current buffer. 
Name and length of all non-zero- 
length auxiliary buffers. 
Names of all named regular 
expressions (see the Enter 

- Request). 


Line pointer is not changed. 


In a QED run buffers 0,2, and 

1 were mentioned in that order 

in BUFFER (b) requests. Regular 
expressions alpha and aldrich were 
given names. The current buffer | 
is 1. 


Request: x 


~ Result: 


mat 0018 Q020 
n2oM -QO0T 

non OGO6 

alpha 

aldrich 
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QED REQUESTS 
SUBSTITUTE «3 


Format: adr 1, adr2s/regular expression/string/ 


Purpose: To replace all occurrences of an 


expression (regular expression) in 


the addressed lines with a new 
expression (string). 
"." value: Line pointer is set to the last line é 


substituted, or left unchanged if 
SUBSTITUTE finds no matching lines. 


Defaults adris/regular_expression/string/ | 


is the same as 


adri,adris/regular_expression/string/ 
s/regular expression/string/ 


is the same as 


.s/regular_expression/string/ 


Example: 
Before: 


ai procedure}; Line 1. 
x = y3 Line 2 
xX = Z$ Line 3 
end a; | Line 4 <2 - 


Request: | | | 
—2,3s/x/t/ or /y/3/2/8/x/*/ 
After: aaa? 


a: procedure}; 
t = y3 
Eazy: a 
end a3 
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TRANSFORM 
Format: 


Purpose: 


"." value: 
Default: 


Example: 


QED REQUESTS 


Y 
a 


dri,adr2y/string1/string2/ — 


To replace occurrences of characters in 


~ gtringl with the corresponding character 


of stringe. string! and stringé must be 


of the same length; no character may 


- appear twice in string. 


Set to the last line transformed. 


adrty/string1/string2/ 


1s the same as 


adrt,adriy/string1/string2/ | 
y/string1/string2/ 


is the same as 


.y/string1/string2/ | 


Current Buffer Before: 


AAAAAAA 
Aardvaark 


1, $y/ABC/abo/ 


Current Buffer After: 


aaaaaaa 
aardvaark 
aba 

abaFT 

abb 

abbacY <-« 
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"Lo" value: 


Default: 


Example: — 


— QED REQUESTS 


Ww 
a 


dr1,adr2w type segnam 


To write the addressed lines into 
the segment <segnam>. 


Only one type is recognized. 
This is: 
<sp> ascii, 


therefore, the type parameter may 
be null. : . 4 


A space must appear between w 
and type (or segnam). 


Line pointer is unchanged. 


w type segnam 


is the same as 


1, $w type sepgnam 


Request: 2, 3w sam.ascii 
Result: oo 
The second and third 
lines of the current — 
buffer are written into 
the segment sam.ascii 


in the user's working 
directory. 
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PROBE REQUESTS 


 arglist 
dump_process 
info 7 
initiate 
output 
quit 


— segdump 
| seginfo 
set 


stack 
state 
terminate 


Probe requests perform the following functions: 
1, Direct output from probe to a standard stream 


(console), or direct output to a user specified 
seoment. 


.« Dump machine conditions and register contents. 
~» Dump all or part of a segment. | 
. Dump the contents of an entire process directory. 


. Print size, access, and date of creation 
information for one segment or a group of 
segments. | 


Print a stack trace for a process. | 
Print argument list for a stack frame. 
. Make a segment known or unknown to the system. 


. Print a summary of available probe requests. 


. Make an octal patch to a segment. 
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ARGLIST 


Format: 


Purpose: 


~Examplel: 


Fxample2: 


PROBE REQUESTS 


arglist stack frame 


To print an argument list for the 


specified stack frame. 


stack is the name or number of the stack 
seoment 


frame is the name of the "owning procedure" 
or starting offset of a stack frame. 


If stack is not given, the current stack 
is assumed; the argument list for the last 
occurrence of frame in the current stack 
1s printed. 


arglist 4760 


Might cause the following to be printed 
for frame 4760 in the current stack: 


arg_1 Fixed, bin 
| 260 
arg 2 varying character string 
"no_comment_necessary" 
arg_3 bit string 
1260 


arglist stack_0O gim 


The example presumes operation ina 
ring other than ring 0. Therefore, 
the ring 0 stack is given, followed by 
the requested frame. 
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PROBE REQUESTS 


DUMP_PROCESS 


| Ponnats 


Purpose: 


Note: 


Example: 


dump_process process_id 


To obtain an octal dump of each segment 
in the process whose unique identifier 


is given by processuid. The unique 
process_id may be given in octal or as 


a character string. If no argument is 


given, an octal dump of the current 
user process will result. 


Normally, output will be directed by 
the use of the output request to a 
seoment for later printing. 


- dump_process 
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PROBE REQUESTS ~ 
INFO. | 


Format: info 


Purpose: To provide a complete list of probe 
requests with pertinent parameters 
and options and provide an abbrevi- 

6 ; ated explanation of the request's use. 
xample | 


- info — 


See BX.10.00A for complete descriptions. 
The following requests are available: 


arglist | - list of stack frames 
info obtain this listing 
Initiate xxx | | make a segment known to process 
output p —xxx- direct to a specific medium 
segdump xxx part of a segment in octal 
SEOMENTS =XXX=— =XXxX= print information about a 
, group of segments 
segstatus Xxx print information about 
| one segment 

stack -xxx- -yyy- print a stack trace of segment 

-_ starting with frame yyy 
terminate — make a segment unknown to 

| " process | 
quit = return to command level 


Note: The current: info printout shown above is not 
complete and will probably change shortly. 
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INITIATE 


Format: 


Purpose: 


Example: 


Request : 


Response: 


PROBE REQUESTS 


initiate path reference 


To make the segment given by path 


known to the process being debugged by 
the reference name given by reference. 
If reference is not given,the entry name 
of the segment will be used. 


initiate bin_oct 


Segment bin oct initiated. Number 41 
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PROBE REQUESTS ~ 
OUTPUT 


Format: output console 
output segment path 


Purpose: output console -directs output from 
probe request to 
the console. 


output segment path-directs output to a 
segment whose path= 
name is path. 


Note: By default, output of probe requests is 
| printed on the console. The output 
console request need only be issued 
after a previous output segment path. 


Example: probe 
W 924:09.4 
- output segment text_prog (request ) 


Output directed to segment text_prog. 
Number 227° (response) 


- state (The output of probe request, 
7 state, is to text_prog in 
the user's working directory.) 


- output console (Subsequent probe | 
request to redirect output to 
the console. ) 
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PROBE REQUESTS 
QUIT 
Format: quit 


Purpose: To stop processing probe requests 
and return to Multics command level. 


Example: 


- guit 
r 5:04.0 19.2 40 
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SEGDUMP 


Format: 


Purpose: 


Note: 


Example: 


 UPDEF. - 


PROBE REQUESTS 


segdump seg lower upper 


To produce an octal dump of the segment 


seg from the lower bound specified by 
lower to the upper bound specified by 


seg is the segment name or an 


octal number which designates a segment 


in the KST, 


If the parameter upper is not specified, 
the segment is dumped from lower to the 
current length of the segment. | 


If neither parameter is specified, the 
entire segment is dumped. 


If the segment is not known to the 
process, the comment: segment not yet 
initiated is printed. | 


= segdump 203 1700 1777 
Segment multics 000203 


001700 © 
001710 
001720 
001730 
001740 
001750 
001760 


001770 


0001143 52000 
6005563 50100 


600560252100 
600556757100 


0002223 52000 
01000043 1007 


400064710120 
6000243 57100 


0002423 52000 
6005563 50100 


600560252100 
600556757100 


0002323 52000 
01000043 1007 


400070710120 
600562252100 
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600556757100 
000226352000 


010000431007 
1.00062710120 


600562252100 
6000243 57100 


6005563 50100 
600560252100 


600556757100 
0002323 52000 


010000431007 
400070710120 


600562252100 
6000243 57100 


0002643 52000 
6005563 50100 


oEG INFO 
Format: 
Purpose: 


; Example: 


PROBE REQUESTS 


seginfo segl sepg2 all long | 

To print a list of segment names and num- 
bers known to the process from segment segp1 
through segment sega. 


segl and segg are either segment names or 
numbers known to the process being debugged. 
If seg2 is blank, a list of all segments 
from segt are printed. If both seg1t and sep2 
are blank, names of all segments known to 


the process are printed. Source of informa- 
tion for the list is the KST. 


all is an optional literal causing all the 
reference names for each listed segment to 

be printed. (A reference name is a name in 
the KST by which a segment is known to a 
process). 

long is an optional literal causing the fol- 
lowing information to be printed for each 
listed segment: current length, access modes 
and date created. 

If a request is: seginfo 


a list of all segments known to the process 
being debugged is printed. 


Any combination of parameters to the seginfo 
request 1S permissible, except use of seg2 
without a preceding seg. 


seginfo 200 test_proc long 
Results: 


200 root>sys_root>sys_1ib>cv_string.1ink 

1 rewa 12/31/68 1900.0 EST MON 
201 = root>sys_root>sys_]l ib>get_count 
| 8 re 12/31/68 1900.0 EST MON 
202 root>sys_root>sys_lib>sys_info.1ink 

1 re 12/31/68 1900.0 EST MON 
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PROBE REQUESTS _ 


SET 


Format: set seg|location valuel yalue2 .... 


Purpose: To place values beginning with value! 
in the segment given by seg, beginning 
at the location given by location. © 
valuel is placed in location, value2 
in location+1, etc. At least one value 
must be present. The request allows 
octal patching of segments for which 
the user has write permission, 


Notes: seg may be a symbolic name or segment 
| number. 


Example: set 20311700 000224251000 600525210000 


where the values given replace the 
current values in locations 001700 
and 001701 of the segment numbered 203. 
Probe prints out the values before and 
after the change. 
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PROBE REQUESTS 


stack seg frame f args 


To trace the sequence of calls in stack seg- 


ment seg starting at location frame. seg may 


Example: 


be a sepment number or name. If frame is gi- 
ven in octal, it is interpreted as a frame 
number. If frame is given as a segment name, 


the stack is examined for a frame belonging to 
the segment. Tracing starts at that frame. 


Default tracing is from end to beginning of — 
the stack through ring-crossing frames. Op- 
tional literal f causes tracing to proceed 
from beginning to end, terminating when a 
ring-crossing frame is encountered. 


\lf neither seg nor frame are given, the cur- 


rent stack is assumed. seg must be given if 
frame is given. If frame is not given, trac- 
ing proceeds from either the beginning or end 
of stack as appropriate. 


Optional literal args causes a listof all argu- 


ments passed to each stack frame to be printed. 


For each frame, the name and number of the 
segment using the frame, starting location in 
the stack segment, and frame size are printed. 


- stack | 
stack trace of sepment stack_01. Number 000171. 


Number Name = Start 51ze 


0226 probe!1314 003540 0170 
0226 probe |223 003410 0130 
0225 shell_char!4242 002150 1215 
0225  shell_char|1075 001610 0340 
0225  signal|464 001340 0250 
0011 fim |56 001160 0160 
0203. multics |1747 000310 0650 
0206 bit_to| 2147 000220 0070 
0203 multics|3153 000050 0150 
0000 NOCALLIO 000010 0040 
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PROBE REQUESTS 
6 STATE 


Formats: 


Request Mean} of Request 


state arith Print contents of A, Q, and 
exponent registers. 


state bases Print contents of & base 
registers. 


state cunit Print control unit contents 
and ring number. | 


state index Print contents of 8 index 
registers. 


state location Print the fault location and 
the computed address. 


state timer Print contents of timer 
: register. 


State: | Print all or the above 


Purpose: To print the available status informa- 
tion for the process being debugged. 


Example: state | 


As QOO0004000000 ~ Q: 000000000000 
Exponent: 000000000000 Indicator: 10 
Timer: 430351270000 

Fault at 203|1746 

Effective address 201|162 | 

Index registers: 3 000 171 0 410 66 
Base registers: 

ap: 001066100000 ab: 000171040000 

bp: 000242300000 bb: 000203040000 

Ip: 000072500000 lb: 000201040000 

sp: 000310700000 sb: 000171060000 
Control unit: 

000201022001 000162000200 000203200700 001746001000 
000162710120 000232352000 

Ring: 001 
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PROBE REQUESTS 
TERMINATE | 


Format: terminate path 


Purpose: To make the segment given by path 
unknown to the process by removing it 
from the KST. 


Example: terminate bin oct 


/ 
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